@carlesandres/house 0.4.11 → 0.4.13

package/CHANGELOG.md

@@ -6,6 +6,28 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 
 ## [Unreleased]
 
+## [0.4.13] — 2026-06-15
+
+### Added
+
+- Command palette now includes a `Copy file contents` action for the selected markdown file, copying the exact on-disk text to the system clipboard on macOS and Linux.
+
+### Changed
+
+- Reader wrapping is now a session mode toggled with `w`: `width` / `--width` defines the fixed wrap width, while `wrap` / `--wrap` / `--no-wrap` controls startup mode. The footer now keeps a persistent `W` indicator for wrap state.
+- The built-in startup focus now defaults to `sidebar` instead of opening the filter prompt immediately; use `--focus filter`, `HOUSE_FOCUS=filter`, or `focus = "filter"` to keep the previous behavior.
+- Removed `--sidebar` as a startup mode; the sidebar now starts visible and remains controlled interactively with `s`, `tab`, and `/` during the session.
+
+### Fixed
+
+- Footer status chrome, palette sizing, and reader wrap width calculations now stay within the visible pane.
+
+## [0.4.12] — 2026-06-14
+
+### Fixed
+
+- Pinned the Effect runtime stack to the latest beta that does not pull `ini@7`, avoiding npm install engine warnings for users on older Node 22 installers.
+
 ## [0.4.11] — 2026-06-14
 
 ### Fixed
@@ -311,7 +333,9 @@ The v1 MVP, published as `@carlesandres/openmdr` on npm.
 
 Search, stdin, URL fetching, cross-file link following, `$EDITOR` hand-off, syntax highlighting, persistent config, OS-appearance auto-detect, single-binary distribution (issue [#2](https://github.com/carlesandres/openmdr/issues/2)), Homebrew tap. All tracked.
 
-[Unreleased]: https://github.com/carlesandres/house/compare/v0.4.11...HEAD
+[Unreleased]: https://github.com/carlesandres/house/compare/v0.4.13...HEAD
+[0.4.13]: https://github.com/carlesandres/house/compare/v0.4.12...v0.4.13
+[0.4.12]: https://github.com/carlesandres/house/compare/v0.4.11...v0.4.12
 [0.4.11]: https://github.com/carlesandres/house/compare/v0.4.10...v0.4.11
 [0.4.10]: https://github.com/carlesandres/house/compare/v0.4.9...v0.4.10
 [0.4.9]: https://github.com/carlesandres/house/compare/v0.4.8...v0.4.9

package/README.md

@@ -64,11 +64,12 @@ house --serve README.md
 | -------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------ |
 | `--theme <name>`     | `opencode`        | Starting theme (see list below)                                                                              |
 | `--tone dark\|light` | `dark`            | Starting tone                                                                                                |
-| `--width <N>`        | —                 | Cap rendered markdown width at N columns                                                                     |
+| `--width <N>`        | `80`              | Reader wrap width used when wrapping is enabled                                                              |
+| `--wrap`             | off               | Start with reader wrapping enabled                                                                           |
+| `--no-wrap`          | off               | Start with reader wrapping disabled                                                                          |
 | `--show <list>`      | `""`              | Reveal normally-skipped entries; comma-separated subset of `hidden`, `gitignored`. Use `--show ""` to clear. |
 | `--root <dir>`       | current directory | Discovery root to walk; overrides `defaultRoot` config/env                                                   |
-| `--sidebar <mode>`   | `auto`            | Initial sidebar visibility: `auto`, `on`, or `off`                                                           |
-| `--focus <mode>`     | `filter`          | Startup focus: `sidebar`, `reader`, or `filter`. `filter` opens the sidebar filter prompt immediately.       |
+| `--focus <mode>`     | `sidebar`         | Startup focus: `sidebar`, `reader`, or `filter`. `filter` opens the sidebar filter prompt immediately.       |
 | `--serve`            | off               | Serve the positional path as HTML in the browser (skips TUI)                                                 |
 | `--port <N>`         | OS-assigned       | Port for `--serve`                                                                                           |
 | `--ext <list>`       | none              | Include extra file extensions (comma-separated)                                                               |
@@ -92,24 +93,28 @@ Run `house --config-path` to print the exact location.
 theme = "tokyonight"
 tone  = "dark"
 extensions = []
+width = 80
+wrap = false
 show  = ["hidden", "gitignored"]
-focus = "filter"
+focus = "sidebar"
 defaultRoot = "cwd" # or "git"
 ```
 
-Supported keys: `theme`, `tone`, `extensions`, `show`, `focus`, `defaultRoot`.
+Supported keys: `theme`, `tone`, `extensions`, `width`, `wrap`, `show`, `focus`, `defaultRoot`.
 
 `show` is a list of normally-skipped categories to opt into. Known categories: `hidden` (dot-prefixed entries), `gitignored` (entries matched by a `.gitignore`). Default is the empty list. Hard skips (`node_modules`, `.git`, `.venv`) always apply.
 
 Precedence, highest to lowest:
 
-1. CLI flags (`--theme`, `--tone`, `--ext`, `--show`, `--focus`, `--root`)
-2. Env vars (`HOUSE_THEME`, `HOUSE_TONE`, `HOUSE_EXTENSIONS`, `HOUSE_SHOW`, `HOUSE_FOCUS`, `HOUSE_DEFAULT_ROOT`)
+1. CLI flags (`--theme`, `--tone`, `--ext`, `--width`, `--wrap`, `--no-wrap`, `--show`, `--focus`, `--root`)
+2. Env vars (`HOUSE_THEME`, `HOUSE_TONE`, `HOUSE_EXTENSIONS`, `HOUSE_WIDTH`, `HOUSE_WRAP`, `HOUSE_SHOW`, `HOUSE_FOCUS`, `HOUSE_DEFAULT_ROOT`)
 3. Config file
-4. Built-in defaults (`opencode` / `dark` / `extensions = []` / `show = []` / `focus = "filter"` / `defaultRoot = "cwd"`)
+4. Built-in defaults (`opencode` / `dark` / `extensions = []` / `width = 80` / `wrap = false` / `show = []` / `focus = "sidebar"` / `defaultRoot = "cwd"`)
 
 `HOUSE_SHOW` takes a comma-separated list (`HOUSE_SHOW=hidden,gitignored`). For `show` specifically, each source completely replaces the next — categories don't merge across layers. Press `shift+a` in the TUI to round-trip between the configured set and the full vocabulary without editing config.
 
+`width` is the fixed reader width used when wrapping is enabled. `wrap` controls startup mode; press `w` in the TUI to toggle reader wrapping for the current session without editing config.
+
 The file is optional — a missing file is fine. Invalid keys, unknown themes, or malformed TOML fail loudly with a one-line error. Per-project config (`.house/config.toml`) and additional keys are deferred.
 
 ## Keys
@@ -122,6 +127,7 @@ The file is optional — a missing file is fine. Invalid keys, unknown themes, o
 | `tab`          | Toggle focus (sidebar ↔ reader)                             |
 | `s`            | Toggle sidebar visibility                                   |
 | `ctrl+p`       | Command palette                                             |
+| `w`            | Toggle reader wrap                                          |
 | `O`            | Open current file in browser as HTML                        |
 | `E`            | Open current file in `$EDITOR` (`$VISUAL` takes precedence) |
 | `t`            | Next theme                                                  |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@carlesandres/house",
-	"version": "0.4.11",
+	"version": "0.4.13",
 	"description": "TUI-first markdown reader on opentui",
 	"type": "module",
 	"license": "MIT",
@@ -51,11 +51,11 @@
 		"prepare": "git config core.hooksPath .githooks 2>/dev/null || true"
 	},
 	"dependencies": {
-		"@effect/atom-react": "4.0.0-beta.70",
+		"@effect/atom-react": "4.0.0-beta.60",
 		"@opentui/core": "0.2.15",
 		"@opentui/react": "0.2.15",
 		"commander": "^14.0.3",
-		"effect": "4.0.0-beta.70",
+		"effect": "4.0.0-beta.60",
 		"ignore": "^7.0.5",
 		"marked": "^18.0.4",
 		"react": "19.2.6",

package/src/Browser.tsx

@@ -25,16 +25,12 @@ import { parseFrontmatter } from "./markdown/frontmatter.ts"
 import { BRAND, BRAND_NAME } from "./brand.ts"
 import { Footer, FOOTER_HEIGHT, type FooterProps } from "./Footer.tsx"
 import { Header, HEADER_HEIGHT } from "./Header.tsx"
+import { copyTextToClipboard } from "./io/clipboard.ts"
 import { openInEditor, resolveEditor } from "./io/editor.ts"
 import { readFileText } from "./io/readFile.ts"
 import { browserBindings, type BrowserCtx } from "./keymap/browser.ts"
 import { dispatch } from "./keymap/keymap.ts"
-import {
-	canFitInline,
-	defaultPreferredWidth,
-	initialShownForAuto,
-	resolveSidebarWidth,
-} from "./layout/resolve.ts"
+import { canFitInline, defaultPreferredWidth, resolveSidebarWidth } from "./layout/resolve.ts"
 import { fitSidebarEmptyValue } from "./layout/sidebarEmptyState.ts"
 import { formatSidebarRow } from "./layout/sidebarRow.ts"
 import { PromptRow } from "./PromptRow.tsx"
@@ -48,7 +44,6 @@ import { themeDefinitions, getThemeDefinition } from "./theme/registry.ts"
 import { saveThemePreference } from "./config/save.ts"
 import { middleTruncate } from "./ui/middleTruncate.ts"
 
-export type SidebarMode = "auto" | "on" | "off"
 export type StartupFocus = "sidebar" | "reader" | "filter"
 
 export interface BrowserProps {
@@ -56,8 +51,10 @@ export interface BrowserProps {
 	readonly initialIndex?: number
 	/** Initial applied filter query seeded from the CLI positional. */
 	readonly initialQuery?: string
-	/** Cap the rendered markdown's width at N columns. Null = fill the pane. */
-	readonly maxWidth?: number | null
+	/** Reader wrap width used when wrapping is enabled. */
+	readonly wrapWidth?: number
+	/** Initial reader wrap mode. Runtime toggles are session-only. */
+	readonly initialWrap?: boolean
 	/** Discovery root label used in the post-discovery empty-vault sidebar row. */
 	readonly emptyRootLabel?: string
 	/** Persistent footer indicator (e.g. "indexing… 42"). Pass null/undefined
@@ -74,12 +71,11 @@ export interface BrowserProps {
 	readonly renderedPathDebounceMs?: number
 	/** Test seam: disable reader-empty-state tip rotation effect. */
 	readonly disableReaderEmptyStateRotation?: boolean
-	/** Initial sidebar visibility (`--sidebar` flag). `auto` consults the
-	 *  launch viewport bucket once; subsequent visibility goes through `s`. */
-	readonly sidebarMode?: SidebarMode
 	readonly onQuit?: () => void
 	/** Test seam: replaces the file reader. */
 	readonly readFile?: (path: string) => Promise<string>
+	/** Test seam: replaces the system clipboard writer. */
+	readonly copyToClipboard?: (text: string) => Promise<void>
 	/** Optional one-shot footer toast surfaced on first appearance (e.g. the
 	 *  "update available" nudge). Shown with an extended TTL so the user has
 	 *  time to read it; subsequent transient toasts (theme cycle, etc.)
@@ -189,7 +185,8 @@ export const Browser = ({
 	files,
 	initialIndex = 0,
 	initialQuery = "",
-	maxWidth = null,
+	wrapWidth = 80,
+	initialWrap = false,
 	emptyRootLabel = "current root",
 	discoveryStatus = null,
 	discoverySpinnerIntervalMs,
@@ -198,9 +195,9 @@ export const Browser = ({
 	filterDebounceMs = FILTER_DEBOUNCE_MS,
 	renderedPathDebounceMs = RENDERED_PATH_DEBOUNCE_MS,
 	disableReaderEmptyStateRotation = false,
-	sidebarMode = "auto",
 	onQuit,
 	readFile = defaultReadFile,
+	copyToClipboard = copyTextToClipboard,
 	updateNotice = null,
 	updateNoticeTtlMs = 10000,
 	disableFooterNoticeAutoClear = false,
@@ -216,24 +213,13 @@ export const Browser = ({
 	const [selectedIndex, setSelectedIndex] = useState(() =>
 		clamp(initialIndex, 0, Math.max(0, files.length - 1)),
 	)
+	const [wrapEnabled, setWrapEnabled] = useState(initialWrap)
 	const [loaded, setLoaded] = useState<{ path: string; content: string } | null>(null)
 	const [error, setError] = useState<string | null>(null)
-	// `shown` is the user's sticky preference. Visibility is derived:
-	// `visible = shown || focus === "sidebar"`. See DESIGN.md §7.1.
-	//
-	// Launch consults the viewport bucket once for `--sidebar=auto`. The
-	// useState initializer pins this to the first render — buckets are
-	// launch-only by design, so resize must NOT re-evaluate.
-	const [shown, setShown] = useState<boolean>(() => {
-		switch (sidebarMode) {
-			case "on":
-				return true
-			case "off":
-				return false
-			case "auto":
-				return initialShownForAuto(width)
-		}
-	})
+	// `shown` is the user's sticky interactive preference. The sidebar starts
+	// visible; after launch, `s`/`tab`/`/` may hide or reveal it. Visibility is
+	// derived: `visible = shown || focus === "sidebar"`. See DESIGN.md §7.1.
+	const [shown, setShown] = useState<boolean>(true)
 	const startInFilter = startupFocus === "filter"
 	const initialFocus: "sidebar" | "reader" =
 		startupFocus === null
@@ -245,13 +231,12 @@ export const Browser = ({
 				: "sidebar"
 	// `filter` mirrors `openFilter`'s focus rule: the filter input lives in
 	// the sidebar, so opening it on mount also forces sidebar focus regardless
-	// of `--sidebar=off` (§7.1's visibility derivation surfaces the sidebar via
-	// focus even when `shown` is false). Plain `sidebar` startup shares the
-	// same pane focus without opening the prompt. When omitted, preserve the
-	// legacy Browser behavior: initial focus follows visibility.
-	const [focus, setFocus] = useState<"sidebar" | "reader">(() =>
-		shown || initialFocus === "sidebar" ? "sidebar" : "reader",
-	)
+	// of the current interactive visibility state (§7.1's visibility derivation
+	// surfaces the sidebar via focus even when `shown` is false). Plain
+	// `sidebar` startup shares the same pane focus without opening the prompt.
+	// When omitted, preserve the legacy Browser behavior: initial focus follows
+	// visibility.
+	const [focus, setFocus] = useState<"sidebar" | "reader">(() => initialFocus)
 	const [sidebarScroll, setSidebarScroll] = useState<number>(0)
 	const [filterOpen, setFilterOpen] = useState<boolean>(startInFilter)
 	const [filterInput, setFilterInput] = useState<string>(initialQuery)
@@ -492,6 +477,7 @@ export const Browser = ({
 		restoreFilterOnSidebarFocus: restoreFilterOnSidebarFocusRef.current,
 		filterQuery: filterInput,
 		paletteOpen,
+		wrapEnabled,
 		setFocus,
 		// Wrapped so any keymap-driven selection move (j/k/g/G/[/], reader
 		// prev/next) clears the pending-restore ref from #145. Internal
@@ -565,6 +551,7 @@ export const Browser = ({
 			setPaletteIndex(0)
 			dispatchFloatingOverlay({ type: "open-command-palette" })
 		},
+		toggleWrap: () => setWrapEnabled((prev) => !prev),
 		cycleTheme,
 		toggleTone,
 		toggleAll: () => {
@@ -674,6 +661,26 @@ export const Browser = ({
 				}
 			})()
 		},
+		copyCurrentContents: () => {
+			const file = displayedFiles[selectedIndex]
+			if (!file) return
+			void (async () => {
+				let text: string
+				try {
+					text = await readFile(file.path)
+				} catch {
+					pushFooterNotice(`copy failed: cannot read ${file.relativePath}`)
+					return
+				}
+				try {
+					await copyToClipboard(text)
+					pushFooterNotice(`copied ${file.relativePath}`)
+				} catch (err) {
+					const message = err instanceof Error ? err.message : String(err)
+					pushFooterNotice(`copy failed: ${message}`)
+				}
+			})()
+		},
 	}
 
 	useKeyboard((key) => {
@@ -860,6 +867,12 @@ export const Browser = ({
 	const isNarrow = !canFitInline(width)
 	const sidebarInline = isNarrow ? sidebarActive : shown || sidebarActive
 	const readerVisible = isNarrow ? readerActive : true
+	// When fixed-width wrapping is enabled, never size markdown wider than the
+	// visible reader body. The scrollbox deliberately disables horizontal
+	// scrolling, so an over-wide markdown node clips instead of wrapping.
+	const readerPaneWidth = isNarrow || !sidebarInline ? width : Math.max(1, width - sidebarWidth)
+	const readerBodyWidth = Math.max(1, readerPaneWidth - 2) // reader padding: 1 left + 1 right
+	const markdownWidth = wrapEnabled ? Math.min(wrapWidth, readerBodyWidth) : "100%"
 	// Currently-selected file shown in the Header (which replaced the
 	// per-pane border title that used to carry this information).
 	const currentFile = selected?.relativePath ?? null
@@ -924,6 +937,15 @@ export const Browser = ({
 		width,
 		notice: footerNotice?.text ?? null,
 		discoveryStatus,
+		indicators: [
+			{
+				id: "wrap",
+				icon: "W",
+				variant: "info",
+				active: wrapEnabled,
+				onMouseUp: () => setWrapEnabled((prev) => !prev),
+			},
+		],
 		...(discoverySpinnerIntervalMs === undefined ? {} : { discoverySpinnerIntervalMs }),
 		...(discoverySpinnerInitialFrameIndex === undefined
 			? {}
@@ -1162,7 +1184,7 @@ export const Browser = ({
 										fg={colors.text}
 										bg={readerActive ? colors.background : colors.backgroundPanel}
 										conceal
-										style={{ width: maxWidth ?? "100%" }}
+										style={{ width: markdownWidth }}
 									/>
 								</scrollbox>
 							)}

package/src/CommandPalette.tsx

@@ -88,9 +88,12 @@ export const CommandPalette = ({
 	const overlayWidth = Math.min(viewportWidth - 4, 64)
 	const rows = buildRows(commands)
 	// Reserve: 2 for border (top+bottom), 1 query row, 1 spacer below query,
-	// 1 spacer above footer, 1 footer row. Body gets the rest.
+	// 1 spacer above footer, 1 footer row. Body gets the rest. Keep a one-row
+	// viewport margin above and below when possible; the modal itself already
+	// owns a border and clips its body, so a larger fixed margin needlessly hides
+	// the final command on medium-height terminals.
 	const chrome = 2 + 1 + 1 + 1 + 1
-	const maxBody = Math.max(1, viewportHeight - 4 - chrome)
+	const maxBody = Math.max(1, viewportHeight - 2 - chrome)
 	const desiredBody = Math.max(1, rows.length || 1)
 	const bodyHeight = Math.min(desiredBody, maxBody)
 	const overlayHeight = chrome + bodyHeight

package/src/Footer.tsx

@@ -24,6 +24,7 @@ import type React from "react"
 import type { KeyBinding } from "./keymap/keymap.ts"
 import { displayKey } from "./keymap/displayKey.ts"
 import { Spinner } from "./Spinner.tsx"
+import { StatusIndicator, type StatusIndicatorProps } from "./StatusIndicator.tsx"
 import { colors } from "./theme/colors.ts"
 
 /** Rows the Footer occupies. Importers use it for layout math so a future
@@ -39,6 +40,8 @@ export interface FooterProps<C> {
 	 *  no TTL, cleared by the caller when the underlying activity finishes.
 	 *  Loses to `notice` when both are set so transient toasts still surface. */
 	readonly discoveryStatus?: string | null
+	/** Persistent compact state/status indicators, rendered after built-in warning indicators. */
+	readonly indicators?: readonly (StatusIndicatorProps & { readonly id: string })[]
 	/** Test seam: override spinner tick speed so tests don't sleep on the full
 	 *  production interval. Ignored when discoveryStatus is null. */
 	readonly discoverySpinnerIntervalMs?: number
@@ -86,6 +89,7 @@ const fitHints = (hints: readonly Hint[], width: number): Hint[] => {
 }
 
 const STATUS_SEPARATOR = " · "
+const NON_WARNING_STATUS_PREFIX_WIDTH = 2 // 1-cell spinner + 1-cell spacer
 
 const isPartialDiscoveryWarning = (status: string | null): boolean =>
 	status?.startsWith("scan incomplete:") ?? false
@@ -96,6 +100,7 @@ export const Footer = <C,>({
 	width,
 	notice,
 	discoveryStatus,
+	indicators = [],
 	discoverySpinnerIntervalMs,
 	discoverySpinnerInitialFrameIndex,
 	discoverySpinnerRegisterTick,
@@ -130,19 +135,48 @@ export const Footer = <C,>({
 	const status =
 		discoveryStatus && discoveryStatus.length > 0 ? normalizeStatusLine(discoveryStatus) : null
 	const isPartialWarning = isPartialDiscoveryWarning(status)
+	const renderedIndicators = [
+		...(isPartialWarning
+			? [
+					{
+						id: "discovery-warning",
+						icon: "!",
+						variant: "warning" as const,
+						active: true,
+						...(onDiscoveryWarningToggle === undefined
+							? {}
+							: { onMouseUp: onDiscoveryWarningToggle }),
+					},
+				]
+			: []),
+		...indicators,
+	]
+	const indicatorBudget = Math.min(usableWidth, renderedIndicators.length * 3)
+	const contentBudget = Math.max(0, usableWidth - indicatorBudget)
+	const statusChromeWidth = status
+		? (isPartialWarning ? 0 : NON_WARNING_STATUS_PREFIX_WIDTH) + STATUS_SEPARATOR.length
+		: 0
 	const statusBudget = status
-		? Math.min((isPartialWarning ? 1 : status.length) + STATUS_SEPARATOR.length, usableWidth)
+		? Math.min((isPartialWarning ? 0 : status.length) + statusChromeWidth, contentBudget)
 		: 0
-	const hintsWidth = Math.max(0, usableWidth - statusBudget)
+	const hintsWidth = Math.max(0, contentBudget - statusBudget)
 	const visibleHints = fitHints(hints, hintsWidth)
-	const statusContent = status
-		? status.slice(0, Math.max(0, statusBudget - STATUS_SEPARATOR.length))
+	const nonWarningStatusPrefixBudget =
+		status && !isPartialWarning ? Math.min(NON_WARNING_STATUS_PREFIX_WIDTH, statusBudget) : 0
+	const statusContent = status ? status.slice(0, Math.max(0, statusBudget - statusChromeWidth)) : ""
+	const statusSeparatorContent = status
+		? STATUS_SEPARATOR.slice(
+				0,
+				Math.max(0, statusBudget - nonWarningStatusPrefixBudget - statusContent.length),
+			)
 		: ""
 	const noticeContent = notice
-		? notice.length > usableWidth
-			? notice.slice(0, usableWidth)
+		? notice.length > contentBudget
+			? notice.slice(0, contentBudget)
 			: notice
 		: null
+	const renderIndicators = () =>
+		renderedIndicators.map(({ id, ...props }) => <StatusIndicator key={id} {...props} />)
 
 	// Two-tone hint row: keys render in `text` (foreground-strength), the
 	// `:label` portion in `textMuted`. Matches ghui's footer treatment so
@@ -177,25 +211,12 @@ export const Footer = <C,>({
 	if (noticeContent !== null) {
 		return (
 			<box style={rowStyle}>
+				{renderIndicators()}
 				<text content={noticeContent} wrapMode="none" style={{ fg: colors.primary }} />
 			</box>
 		)
 	}
 
-	const warningTrigger = isPartialWarning ? (
-		<box
-			{...(onDiscoveryWarningToggle === undefined ? {} : { onMouseUp: onDiscoveryWarningToggle })}
-			style={{
-				width: 1,
-				height: 1,
-				flexDirection: "row",
-				backgroundColor: colors.backgroundElement,
-			}}
-		>
-			<text content="!" wrapMode="none" style={{ fg: colors.warning, attributes: 1 }} />
-		</box>
-	) : null
-
 	if (status !== null) {
 		const spinnerProps = {
 			fg: colors.secondary,
@@ -212,20 +233,26 @@ export const Footer = <C,>({
 
 		return (
 			<box style={rowStyle}>
-				{isPartialWarning ? null : <Spinner {...spinnerProps} />}
-				{isPartialWarning ? null : (
+				{renderIndicators()}
+				{nonWarningStatusPrefixBudget >= 1 ? <Spinner {...spinnerProps} /> : null}
+				{nonWarningStatusPrefixBudget >= 2 ? (
 					<text content=" " wrapMode="none" style={{ fg: colors.textMuted }} />
-				)}
-				{isPartialWarning ? (
-					warningTrigger
-				) : (
+				) : null}
+				{isPartialWarning ? null : (
 					<text content={statusContent} wrapMode="none" style={{ fg: colors.secondary }} />
 				)}
-				<text content={STATUS_SEPARATOR} wrapMode="none" style={{ fg: colors.textMuted }} />
+				{statusSeparatorContent.length > 0 && (
+					<text content={statusSeparatorContent} wrapMode="none" style={{ fg: colors.textMuted }} />
+				)}
 				{renderHints()}
 			</box>
 		)
 	}
 
-	return <box style={rowStyle}>{renderHints()}</box>
+	return (
+		<box style={rowStyle}>
+			{renderIndicators()}
+			{renderHints()}
+		</box>
+	)
 }

package/src/StatusIndicator.tsx

@@ -0,0 +1,55 @@
+import { colors } from "./theme/colors.ts"
+
+export type StatusIndicatorVariant = "info" | "warning" | "error" | "success"
+
+export interface StatusIndicatorProps {
+	readonly icon: string
+	readonly variant?: StatusIndicatorVariant
+	readonly active?: boolean
+	readonly onMouseUp?: () => void
+}
+
+export const statusIndicatorFg = (variant: StatusIndicatorVariant): string => {
+	switch (variant) {
+		case "info":
+			return colors.info
+		case "warning":
+			return colors.warning
+		case "error":
+			return colors.error
+		case "success":
+			return colors.success
+	}
+}
+
+export const StatusIndicator = ({
+	icon,
+	variant = "info",
+	active = true,
+	onMouseUp,
+}: StatusIndicatorProps) => {
+	const activeColor = statusIndicatorFg(variant)
+	const backgroundColor = active ? activeColor : colors.backgroundElement
+
+	return (
+		<box
+			{...(onMouseUp === undefined ? {} : { onMouseUp })}
+			style={{
+				width: 3,
+				height: 1,
+				flexDirection: "row",
+				backgroundColor,
+			}}
+		>
+			<text
+				content={` ${icon} `}
+				wrapMode="none"
+				style={{
+					fg: active ? colors.backgroundPanel : colors.textMuted,
+					bg: backgroundColor,
+					attributes: active ? 1 : 0,
+				}}
+			/>
+		</box>
+	)
+}

package/src/StatusPopover.tsx

@@ -1,5 +1,6 @@
 import { useTerminalDimensions } from "@opentui/react"
 import { useMemo, useState } from "react"
+import { StatusIndicator, statusIndicatorFg } from "./StatusIndicator.tsx"
 import { colors } from "./theme/colors.ts"
 
 export type StatusPopoverVariant = "info" | "warning" | "error" | "success"
@@ -29,19 +30,6 @@ export interface StatusPopoverPanelProps {
 
 const clamp = (n: number, min: number, max: number) => Math.max(min, Math.min(max, n))
 
-const variantFg = (variant: StatusPopoverVariant): string => {
-	switch (variant) {
-		case "info":
-			return colors.info
-		case "warning":
-			return colors.warning
-		case "error":
-			return colors.error
-		case "success":
-			return colors.success
-	}
-}
-
 const measureLine = (line: string): number => line.length
 
 const wrapLine = (line: string, width: number): string[] => {
@@ -96,22 +84,11 @@ export const StatusPopover = ({
 
 	const linesToRender = wrapped.slice(0, Math.max(0, popoverHeight - 2))
 	while (linesToRender.length < popoverHeight - 2) linesToRender.push("")
-	const triggerFg = variantFg(variant)
-	const borderColor = variantFg(variant)
+	const borderColor = statusIndicatorFg(variant)
 
 	return (
 		<>
-			<box
-				onMouseUp={() => setOpen(!isOpen)}
-				style={{
-					width: 3,
-					height: 1,
-					flexDirection: "row",
-					backgroundColor: colors.backgroundElement,
-				}}
-			>
-				<text content={` ${icon} `} wrapMode="none" style={{ fg: triggerFg, attributes: 1 }} />
-			</box>
+			<StatusIndicator icon={icon} variant={variant} active onMouseUp={() => setOpen(!isOpen)} />
 			{showPanel && isOpen && (
 				<box
 					position="absolute"
@@ -162,7 +139,7 @@ export const StatusPopoverPanel = ({
 	const linesToRender = wrapped.slice(0, Math.max(0, popoverHeight - 2))
 	while (linesToRender.length < popoverHeight - 2) linesToRender.push("")
 
-	const borderColor = variantFg(variant)
+	const borderColor = statusIndicatorFg(variant)
 
 	return (
 		<box

package/src/cli/argv.ts

@@ -12,6 +12,10 @@ export interface ParsedArgs {
 	readonly tone: string | null
 	/** Value of `--width <N>`, or null. Validated by the boot layer (must be a positive integer). */
 	readonly width: string | null
+	/** Startup reader wrap override. Null means config/env/default decides. */
+	readonly wrap: boolean | null
+	/** True when both `--wrap` and `--no-wrap` were passed. */
+	readonly wrapConflict: boolean
 	/** True when `--serve` was passed: serve the positional path as HTML, skip TUI. */
 	readonly serve: boolean
 	/** Value of `--port <N>`, or null. Validated by the boot layer. */
@@ -22,8 +26,6 @@ export interface ParsedArgs {
 	readonly version: boolean
 	/** True when `--config-path` was passed: print resolved config path and exit. */
 	readonly configPath: boolean
-	/** Value of `--sidebar <mode>` (`auto`, `on`, `off`), or null. Validated by the boot layer. */
-	readonly sidebar: string | null
 	/** True when `--no-update-check` was passed: suppress the npm-registry
 	 *  probe and the "update available" notice. Mirrors the
 	 *  `NO_UPDATE_NOTIFIER` env var so opt-out is reachable without env state. */
@@ -49,10 +51,11 @@ const createProgram = () =>
 		.option("--theme [id]")
 		.option("--tone [mode]")
 		.option("--width [N]")
+		.option("--wrap")
+		.option("--no-wrap")
 		.option("--serve")
 		.option("--port [N]")
 		.option("--config-path")
-		.option("--sidebar [mode]")
 		.option("--no-update-check")
 		.option("--ext [list]")
 		.option("--focus [mode]")
@@ -67,19 +70,20 @@ const VALUE_FLAGS: ReadonlySet<string> = new Set([
 	"--tone",
 	"--width",
 	"--port",
-	"--sidebar",
 	"--focus",
 	"--show",
 	"--root",
 	"--ext",
 ])
 
-const REMOVED_VALUE_FLAGS: ReadonlySet<string> = new Set(["--sort"])
+const REMOVED_VALUE_FLAGS: ReadonlySet<string> = new Set(["--sort", "--sidebar"])
 
 const BOOLEAN_FLAGS: ReadonlySet<string> = new Set([
 	"--serve",
 	"--config-path",
 	"--no-update-check",
+	"--wrap",
+	"--no-wrap",
 	"--help",
 	"-h",
 	"--version",
@@ -114,6 +118,8 @@ export const parseArgv = (argv: readonly string[]): ParsedArgs => {
 	const opts = program.opts<Record<string, unknown>>()
 	const pathArg = findPathArg(argv)
 	const stringOrNull = (value: unknown): string | null => (typeof value === "string" ? value : null)
+	const hasWrap = argv.includes("--wrap")
+	const hasNoWrap = argv.includes("--no-wrap")
 
 	return {
 		path: typeof pathArg === "string" ? pathArg : null,
@@ -121,12 +127,13 @@ export const parseArgv = (argv: readonly string[]): ParsedArgs => {
 		theme: stringOrNull(opts["theme"]),
 		tone: stringOrNull(opts["tone"]),
 		width: stringOrNull(opts["width"]),
+		wrap: hasWrap ? true : hasNoWrap ? false : null,
+		wrapConflict: hasWrap && hasNoWrap,
 		serve: opts["serve"] === true,
 		port: stringOrNull(opts["port"]),
 		help: opts["help"] === true,
 		version: opts["version"] === true,
 		configPath: opts["configPath"] === true,
-		sidebar: stringOrNull(opts["sidebar"]),
 		noUpdateCheck: opts["noUpdateCheck"] === true,
 		extensions: stringOrNull(opts["ext"]),
 		show: stringOrNull(opts["show"]),
@@ -145,12 +152,13 @@ export const usage = `usage:
 options:
   --theme <id>   color theme: ${themeList} (default: opencode)
   --tone <mode>  dark or light (default: dark)
-  --width <N>    cap rendered markdown width at N columns
+  --width <N>    reader wrap width used when wrapping is enabled (default: 80)
+  --wrap         start with reader wrapping enabled
+  --no-wrap      start with reader wrapping disabled
   --show <list>  reveal normally-skipped entries; comma-separated subset of:
                    hidden, gitignored. Use --show "" to clear.
   --root <dir>   discovery root to walk (overrides defaultRoot config/env)
-  --sidebar <m>  initial sidebar visibility: auto (default), on, or off
-  --focus <m>    startup focus: sidebar, reader, or filter (default: filter)
+  --focus <m>    startup focus: sidebar, reader, or filter (default: sidebar)
   --serve        serve the positional path as HTML in the browser (skips TUI)
   --port <N>     port for --serve (default: OS-assigned)
   -h, --help     show this help and exit
@@ -166,6 +174,6 @@ examples:
 
 configuration:
   file: $XDG_CONFIG_HOME/house/config.toml  (default ~/.config/house/config.toml)
-	  keys: theme, tone, extensions, show, focus, defaultRoot
-	  env:  HOUSE_THEME, HOUSE_TONE, HOUSE_EXTENSIONS, HOUSE_SHOW, HOUSE_FOCUS, HOUSE_DEFAULT_ROOT
+	  keys: theme, tone, width, wrap, extensions, show, focus, defaultRoot
+	  env:  HOUSE_THEME, HOUSE_TONE, HOUSE_WIDTH, HOUSE_WRAP, HOUSE_EXTENSIONS, HOUSE_SHOW, HOUSE_FOCUS, HOUSE_DEFAULT_ROOT
   precedence (high → low): flags → env → file → defaults`

package/src/commands/buildCommands.ts

@@ -55,6 +55,7 @@ const annotations: Record<string, Annotation> = {
 		keywords: ["hidden", "gitignore", "dotfiles", "all"],
 	},
 	"reader.back": { title: "Back to sidebar", category: "Navigation" },
+	"reader.wrap.toggle": { title: "Toggle reader wrap", category: "View" },
 	"reader.prevFile": { title: "Previous file", category: "Navigation" },
 	"reader.nextFile": { title: "Next file", category: "Navigation" },
 	"serve.current": { title: "Open in browser", category: "File" },

package/src/commands/paletteOnlyCommands.ts

@@ -13,4 +13,15 @@
 import type { BrowserCtx } from "../keymap/browser.ts"
 import type { AppCommand } from "./types.ts"
 
-export const paletteOnlyCommands = (_ctx: BrowserCtx): readonly AppCommand[] => []
+export const paletteOnlyCommands = (ctx: BrowserCtx): readonly AppCommand[] =>
+	ctx.hasSelected
+		? [
+				{
+					id: "file.copyContents",
+					title: "Copy file contents",
+					category: "File",
+					keywords: ["copy", "clipboard", "contents", "markdown"],
+					run: () => ctx.copyCurrentContents(),
+				},
+			]
+		: []

package/src/config/load.ts

@@ -20,6 +20,10 @@ export interface HouseConfig {
 	readonly theme: string
 	readonly tone: "dark" | "light"
 	readonly extensions: readonly string[]
+	/** Reader wrap width used when wrapping is enabled. */
+	readonly width: number
+	/** Whether the reader starts with fixed-width wrapping enabled. */
+	readonly wrap: boolean
 	/** Default discovery-root strategy when no explicit `--root` flag is passed. */
 	readonly defaultRoot: "cwd" | "git"
 	/** Categories of normally-skipped entries to opt into. See
@@ -40,6 +44,8 @@ export interface CliOverrides {
 	 *  other CLI override here). `--show ""` sets the empty set. */
 	readonly show: readonly ShowCategory[] | null
 	readonly focus: "sidebar" | "reader" | "filter" | null
+	readonly width: number | null
+	readonly wrap: boolean | null
 }
 
 const DEFAULT_THEME = "opencode"
@@ -47,7 +53,9 @@ const DEFAULT_TONE: "dark" | "light" = "dark"
 const DEFAULT_EXTENSIONS: readonly string[] = []
 const DEFAULT_ROOT: "cwd" | "git" = "cwd"
 const DEFAULT_SHOW = ""
-const DEFAULT_FOCUS: "sidebar" | "reader" | "filter" = "filter"
+const DEFAULT_FOCUS: "sidebar" | "reader" | "filter" = "sidebar"
+const DEFAULT_WIDTH = 80
+const DEFAULT_WRAP = false
 
 const themeIds = themeDefinitions.map((t) => t.id)
 
@@ -63,6 +71,8 @@ const KNOWN_FILE_KEYS: ReadonlySet<string> = new Set([
 	"extensions",
 	"show",
 	"focus",
+	"width",
+	"wrap",
 	"defaultRoot",
 ])
 
@@ -78,6 +88,8 @@ const schema = Config.all({
 	// so the error message can list valid categories at the field's path.
 	show: Config.schema(Schema.String, "show"),
 	focus: Config.schema(Schema.Literals(["sidebar", "reader", "filter"] as const), "focus"),
+	width: Config.schema(Schema.String, "width"),
+	wrap: Config.schema(Schema.String, "wrap"),
 })
 
 const defaultsProvider = (): ConfigProvider.ConfigProvider =>
@@ -88,8 +100,26 @@ const defaultsProvider = (): ConfigProvider.ConfigProvider =>
 		extensions: DEFAULT_EXTENSIONS.join(","),
 		show: DEFAULT_SHOW,
 		focus: DEFAULT_FOCUS,
+		width: String(DEFAULT_WIDTH),
+		wrap: String(DEFAULT_WRAP),
 	})
 
+const sourceError = (message: string, cause?: unknown): ConfigProvider.SourceError =>
+	new ConfigProvider.SourceError({ message, cause })
+
+const validateFileValue = (path: string, key: string, value: unknown): void => {
+	if (key === "width") {
+		if (!Number.isSafeInteger(value) || (value as number) <= 0) {
+			throw sourceError(`invalid value for width in ${path}: expected a positive integer`)
+		}
+	}
+	if (key === "wrap") {
+		if (typeof value !== "boolean") {
+			throw sourceError(`invalid value for wrap in ${path}: expected true or false`)
+		}
+	}
+}
+
 /**
  * Levenshtein edit distance, capped at `cap` for early exit.
  * Used only to suggest "did you mean X?" when a config key looks like a
@@ -154,15 +184,22 @@ const fileProvider = (
 		const parsed = yield* Effect.try({
 			try: () => Bun.TOML.parse(text) as Record<string, unknown>,
 			catch: (cause) =>
-				new ConfigProvider.SourceError({
-					message: `invalid TOML in ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
+				sourceError(
+					`invalid TOML in ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
 					cause,
-				}),
+				),
 		})
 		const known = [...KNOWN_FILE_KEYS]
 		const filtered: Record<string, unknown> = {}
 		for (const [k, v] of Object.entries(parsed)) {
 			if (KNOWN_FILE_KEYS.has(k)) {
+				yield* Effect.try({
+					try: () => validateFileValue(path, k, v),
+					catch: (cause) =>
+						cause instanceof ConfigProvider.SourceError
+							? cause
+							: sourceError(`invalid value for ${k} in ${path}`, cause),
+				})
 				filtered[k] = v
 			} else {
 				onWarning(formatUnknownKeyWarning(path, k, known))
@@ -206,12 +243,16 @@ const envProvider = (env: Record<string, string | undefined>): ConfigProvider.Co
 	const extensions = env["HOUSE_EXTENSIONS"]
 	const show = env["HOUSE_SHOW"]
 	const focus = env["HOUSE_FOCUS"]
+	const width = env["HOUSE_WIDTH"]
+	const wrap = env["HOUSE_WRAP"]
 	if (theme !== undefined) entries.push(["theme", theme])
 	if (tone !== undefined) entries.push(["tone", tone])
 	if (defaultRoot !== undefined) entries.push(["defaultRoot", defaultRoot])
 	if (extensions !== undefined) entries.push(["extensions", extensions])
 	if (show !== undefined) entries.push(["show", show])
 	if (focus !== undefined) entries.push(["focus", focus])
+	if (width !== undefined) entries.push(["width", width])
+	if (wrap !== undefined) entries.push(["wrap", wrap])
 	return ConfigProvider.fromUnknown(Object.fromEntries(entries))
 }
 
@@ -222,9 +263,28 @@ const cliProvider = (overrides: CliOverrides): ConfigProvider.ConfigProvider =>
 	if (overrides.extensions !== null) entries.push(["extensions", overrides.extensions.join(",")])
 	if (overrides.show !== null) entries.push(["show", overrides.show.join(",")])
 	if (overrides.focus !== null) entries.push(["focus", overrides.focus])
+	if (overrides.width !== null) entries.push(["width", String(overrides.width)])
+	if (overrides.wrap !== null) entries.push(["wrap", String(overrides.wrap)])
 	return ConfigProvider.fromUnknown(Object.fromEntries(entries))
 }
 
+const parsePositiveInteger = (key: string, raw: string): Effect.Effect<number, Error> => {
+	if (!/^\d+$/.test(raw)) {
+		return Effect.fail(new Error(`${key}: expected a positive integer, got ${JSON.stringify(raw)}`))
+	}
+	const value = Number.parseInt(raw, 10)
+	if (!Number.isSafeInteger(value) || value <= 0) {
+		return Effect.fail(new Error(`${key}: expected a positive integer, got ${JSON.stringify(raw)}`))
+	}
+	return Effect.succeed(value)
+}
+
+const parseBoolean = (key: string, raw: string): Effect.Effect<boolean, Error> => {
+	if (raw === "true") return Effect.succeed(true)
+	if (raw === "false") return Effect.succeed(false)
+	return Effect.fail(new Error(`${key}: expected true or false, got ${JSON.stringify(raw)}`))
+}
+
 export interface LoadOptions {
 	readonly cli?: CliOverrides
 	/** Override the TOML path (tests). Defaults to `$XDG_CONFIG_HOME/house/config.toml`. */
@@ -265,6 +325,8 @@ export const loadConfig = (
 		extensions: null,
 		show: null,
 		focus: null,
+		width: null,
+		wrap: null,
 	}
 	const onWarning = options.onWarning ?? ((msg) => process.stderr.write(`${msg}\n`))
 	const provider = cliProvider(cli).pipe(
@@ -273,41 +335,47 @@ export const loadConfig = (
 		ConfigProvider.orElse(defaultsProvider()),
 	)
 	return schema.parse(provider).pipe(
-		Effect.flatMap((raw) => {
-			const defaultRoot =
-				raw.defaultRoot === "cwd" || raw.defaultRoot === "git" ? raw.defaultRoot : DEFAULT_ROOT
-			if (raw.defaultRoot !== defaultRoot) {
-				onWarning(
-					`house: ignoring invalid value ${JSON.stringify(raw.defaultRoot)} for defaultRoot in config/env; using "${DEFAULT_ROOT}"`,
-				)
-			}
-			const parsed = parseShowList(raw.show)
-			if (!parsed.ok) {
-				// Effect's `Config.ConfigError` requires a `SchemaError` or
-				// `SourceError` cause that we don't have a clean constructor
-				// for here — surface as a plain Error and let the boot
-				// layer's existing `formatConfigError` (which already handles
-				// `instanceof Error`) render it.
-				return Effect.fail(
-					new Error(
-						`show: unknown category "${parsed.invalid.join('", "')}" (valid: ${SHOW_CATEGORIES.join(", ")})`,
-					),
-				)
-			}
-			return Effect.succeed({
-				theme: raw.theme,
-				tone: raw.tone,
-				defaultRoot,
-				extensions:
-					raw.extensions === ""
-						? []
-						: raw.extensions
-								.split(",")
-								.map((s) => s.trim())
-								.filter(Boolean),
-				show: parsed.value,
-				focus: raw.focus,
-			})
-		}),
+		Effect.flatMap((raw) =>
+			Effect.gen(function* () {
+				const defaultRoot =
+					raw.defaultRoot === "cwd" || raw.defaultRoot === "git" ? raw.defaultRoot : DEFAULT_ROOT
+				if (raw.defaultRoot !== defaultRoot) {
+					onWarning(
+						`house: ignoring invalid value ${JSON.stringify(raw.defaultRoot)} for defaultRoot in config/env; using "${DEFAULT_ROOT}"`,
+					)
+				}
+				const parsed = parseShowList(raw.show)
+				if (!parsed.ok) {
+					// Effect's `Config.ConfigError` requires a `SchemaError` or
+					// `SourceError` cause that we don't have a clean constructor
+					// for here — surface as a plain Error and let the boot
+					// layer's existing `formatConfigError` (which already handles
+					// `instanceof Error`) render it.
+					return yield* Effect.fail(
+						new Error(
+							`show: unknown category "${parsed.invalid.join('", "')}" (valid: ${SHOW_CATEGORIES.join(", ")})`,
+						),
+					)
+				}
+				const width = yield* parsePositiveInteger("width", raw.width)
+				const wrap = yield* parseBoolean("wrap", raw.wrap)
+				return {
+					theme: raw.theme,
+					tone: raw.tone,
+					defaultRoot,
+					width,
+					wrap,
+					extensions:
+						raw.extensions === ""
+							? []
+							: raw.extensions
+									.split(",")
+									.map((s) => s.trim())
+									.filter(Boolean),
+					show: parsed.value,
+					focus: raw.focus,
+				}
+			}),
+		),
 	)
 }

package/src/index.tsx

@@ -36,8 +36,6 @@ import { useUpdateNotice } from "./update/useUpdateNotice.ts"
  * `Quit` in Browser tears down the renderer and exits, which propagates
  * naturally — the cleanup effect still fires before process.exit completes.
  */
-export type SidebarMode = "auto" | "on" | "off"
-
 const pathIsDirectory = async (path: string): Promise<boolean> => {
 	try {
 		return (await stat(path)).isDirectory()
@@ -107,8 +105,8 @@ interface DiscoverShellProps {
 	 *  independent everywhere else. */
 	readonly initialShow: readonly ShowCategory[]
 	readonly extensions: readonly string[]
-	readonly maxWidth: number | null
-	readonly sidebarMode: SidebarMode
+	readonly wrapWidth: number
+	readonly initialWrap: boolean
 	readonly startupFocus: StartupFocus
 }
 
@@ -117,8 +115,8 @@ export const DiscoverShell = ({
 	initialQuery,
 	initialShow,
 	extensions,
-	maxWidth,
-	sidebarMode,
+	wrapWidth,
+	initialWrap,
 	startupFocus,
 }: DiscoverShellProps) => {
 	const updateNotice = useUpdateNotice()
@@ -194,10 +192,10 @@ export const DiscoverShell = ({
 		<Browser
 			files={files}
 			initialQuery={initialQuery}
-			maxWidth={maxWidth}
+			wrapWidth={wrapWidth}
+			initialWrap={initialWrap}
 			emptyRootLabel={target}
 			discoveryStatus={discoveryStatus}
-			sidebarMode={sidebarMode}
 			startupFocus={startupFocus}
 			updateNotice={updateNotice}
 			onToggleAll={() => {
@@ -240,6 +238,14 @@ if (import.meta.main) {
 		console.log(usage)
 		process.exit(0)
 	}
+	if (args.wrapConflict) {
+		console.error("house: --wrap and --no-wrap cannot be used together")
+		process.exit(2)
+	}
+	if (Bun.argv.slice(2).includes("--width") && args.width === null) {
+		console.error("house: --width requires a positive integer")
+		process.exit(2)
+	}
 	if (args.version) {
 		console.log(pkg.version)
 		process.exit(0)
@@ -282,13 +288,34 @@ if (import.meta.main) {
 					args.focus === "sidebar" || args.focus === "reader" || args.focus === "filter"
 						? args.focus
 						: null,
+				width:
+					args.width === null
+						? null
+						: (() => {
+								const n = Number.parseInt(args.width, 10)
+								if (!/^\d+$/.test(args.width) || !Number.isSafeInteger(n) || n <= 0) {
+									console.error(`house: --width must be a positive integer, got "${args.width}"`)
+									process.exit(2)
+								}
+								return n
+							})(),
+				wrap: args.wrap,
 			},
 		}),
 	).catch((err: unknown) => {
 		console.error(`house: ${formatConfigError(err)}`)
 		process.exit(2)
 	})
-	const { theme: themeId, tone, extensions, show, focus: startupFocus, defaultRoot } = config
+	const {
+		theme: themeId,
+		tone,
+		extensions,
+		show,
+		focus: startupFocus,
+		defaultRoot,
+		width: wrapWidth,
+		wrap: initialWrap,
+	} = config
 	const themeDef = getThemeDefinition(themeId)
 	if (themeDef === undefined) {
 		// Unreachable: Config.schema validated themeId against themeDefinitions.
@@ -297,16 +324,6 @@ if (import.meta.main) {
 	}
 	setActiveTheme(themeDef, tone)
 
-	let maxWidth: number | null = null
-	if (args.width !== null) {
-		const n = Number.parseInt(args.width, 10)
-		if (!Number.isFinite(n) || n <= 0) {
-			console.error(`house: --width must be a positive integer, got "${args.width}"`)
-			process.exit(2)
-		}
-		maxWidth = n
-	}
-
 	const cwd = process.cwd()
 	const discoveryRoot = await resolveDiscoveryRoot({ cliRoot: args.root, defaultRoot, cwd })
 	const initialQuery = resolveInitialQuery({ pathArg: args.path, discoveryRoot, cwd })
@@ -349,14 +366,6 @@ if (import.meta.main) {
 		process.on("SIGTERM", shutdown)
 		// Bun.serve keeps the event loop alive until stop().
 	} else {
-		let sidebarMode: SidebarMode = "auto"
-		if (args.sidebar !== null) {
-			if (args.sidebar !== "auto" && args.sidebar !== "on" && args.sidebar !== "off") {
-				console.error(`house: --sidebar must be "auto", "on", or "off", got "${args.sidebar}"`)
-				process.exit(2)
-			}
-			sidebarMode = args.sidebar
-		}
 		if (args.focus !== null) {
 			if (args.focus !== "sidebar" && args.focus !== "reader" && args.focus !== "filter") {
 				console.error(
@@ -370,10 +379,10 @@ if (import.meta.main) {
 			initialQuery,
 			themeId,
 			tone,
-			maxWidth,
+			wrapWidth,
+			initialWrap,
 			show,
 			extensions,
-			sidebarMode,
 			startupFocus,
 			updateCheck: !args.noUpdateCheck,
 		})
@@ -385,10 +394,10 @@ interface TuiBootOptions {
 	readonly initialQuery: string
 	readonly themeId: string
 	readonly tone: "dark" | "light"
-	readonly maxWidth: number | null
+	readonly wrapWidth: number
+	readonly initialWrap: boolean
 	readonly show: readonly ShowCategory[]
 	readonly extensions: readonly string[]
-	readonly sidebarMode: SidebarMode
 	readonly startupFocus: StartupFocus
 	/** Run the npm-registry probe and surface the "update available" notice.
 	 *  False suppresses both the toast and the quit-time print. */
@@ -400,10 +409,10 @@ async function runTui({
 	initialQuery,
 	themeId,
 	tone,
-	maxWidth,
+	wrapWidth,
+	initialWrap,
 	show,
 	extensions,
-	sidebarMode,
 	startupFocus,
 	updateCheck,
 }: TuiBootOptions): Promise<void> {
@@ -446,8 +455,8 @@ async function runTui({
 				initialQuery={initialQuery}
 				initialShow={show}
 				extensions={extensions}
-				maxWidth={maxWidth}
-				sidebarMode={sidebarMode}
+				wrapWidth={wrapWidth}
+				initialWrap={initialWrap}
 				startupFocus={startupFocus}
 			/>
 		</RegistryProvider>,

package/src/io/clipboard.ts

@@ -0,0 +1,53 @@
+/**
+ * Best-effort clipboard write for macOS/Linux.
+ *
+ * The selected tool is fed through stdin so large or multiline markdown can be
+ * copied without shell quoting issues.
+ */
+
+export interface ClipboardCommand {
+	readonly cmd: string
+	readonly args: readonly string[]
+}
+
+type WhichFn = (command: string) => string | null | undefined
+
+interface CopyToClipboardDeps {
+	readonly platform?: NodeJS.Platform
+	readonly which?: WhichFn
+	readonly spawn?: (command: ClipboardCommand, text: string) => Promise<number>
+}
+
+export const resolveClipboardCommand = (
+	platform: NodeJS.Platform,
+	which: WhichFn,
+): ClipboardCommand | null => {
+	if (platform === "darwin") return { cmd: "pbcopy", args: [] }
+	if (platform !== "linux") return null
+	if (which("wl-copy")) return { cmd: "wl-copy", args: [] }
+	if (which("xclip")) return { cmd: "xclip", args: ["-selection", "clipboard"] }
+	return null
+}
+
+const spawnClipboardCommand = async (command: ClipboardCommand, text: string): Promise<number> => {
+	const proc = Bun.spawn([command.cmd, ...command.args], {
+		stdin: new Response(text),
+		stdout: "ignore",
+		stderr: "ignore",
+	})
+	return await proc.exited
+}
+
+export const copyTextToClipboard = async (
+	text: string,
+	{
+		platform = process.platform,
+		which = Bun.which.bind(Bun),
+		spawn = spawnClipboardCommand,
+	}: CopyToClipboardDeps = {},
+): Promise<void> => {
+	const command = resolveClipboardCommand(platform, which)
+	if (!command) throw new Error("no clipboard tool found")
+	const exitCode = await spawn(command, text)
+	if (exitCode !== 0) throw new Error("clipboard command failed")
+}

package/src/keymap/browser.ts

@@ -23,6 +23,7 @@ export interface BrowserCtx {
 	 *  hint gate so the hint only appears when there is something to clear. */
 	readonly filterQuery: string
 	readonly paletteOpen: boolean
+	readonly wrapEnabled: boolean
 	readonly setFocus: (next: BrowserFocus | ((prev: BrowserFocus) => BrowserFocus)) => void
 	readonly setSelectedIndex: (updater: (prev: number) => number) => void
 	/** Toggle `shown` and adjust focus per DESIGN.md §7.1 (see s-behavior table). */
@@ -33,6 +34,7 @@ export interface BrowserCtx {
 	 *  without first reopening with `/` and backspacing. */
 	readonly clearAndOpenFilter: () => void
 	readonly openPalette: () => void
+	readonly toggleWrap: () => void
 	readonly cycleTheme: (delta: 1 | -1) => void
 	readonly toggleTone: () => void
 	readonly quit: () => void
@@ -41,6 +43,10 @@ export interface BrowserCtx {
 	/** Suspend the TUI, hand the TTY to `$EDITOR`, resume and re-read on
 	 *  exit. No-op when nothing is selected; gating is the binding's job. */
 	readonly editCurrent: () => void
+	/** Copy the currently-selected file's raw contents to the system
+	 *  clipboard. No-op when nothing is selected; palette gating is the
+	 *  primary availability control. */
+	readonly copyCurrentContents: () => void
 	/** Toggle hidden + gitignored discovery axes together (#145 — UI sugar
 	 *  for `shift+a`; the underlying flags stay independent everywhere
 	 *  else). Snapshots the current selected path so it can be restored
@@ -162,6 +168,15 @@ export const browserBindings: readonly KeyBinding<BrowserCtx>[] = [
 		// does not write back to the TOML config.
 		run: (c) => c.toggleAll(),
 	},
+	{
+		id: "reader.wrap.toggle",
+		group: "Global",
+		description: "Toggle reader wrap",
+		hint: "wrap",
+		keys: ["w"],
+		hintWhen: inputClosed,
+		run: (c) => c.toggleWrap(),
+	},
 	{
 		id: "theme.next",
 		group: "Global",

package/src/layout/resolve.ts

@@ -50,11 +50,3 @@ export const defaultPreferredWidth = (viewport: number): number =>
  */
 export const canFitInline = (viewport: number): boolean =>
 	viewport >= SIDEBAR_MIN_WIDTH + DIVIDER_WIDTH + READER_MIN_WIDTH
-
-/**
- * Initial sidebar visibility for `--sidebar=auto`. Always true — every
- * viewport now boots on the sidebar (narrow: as the single visible screen;
- * wide: as the focused inline pane). `--sidebar=off` is the only way to
- * boot directly into the reader.
- */
-export const initialShownForAuto = (_viewport: number): boolean => true