@carlesandres/house 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -2,10 +2,42 @@
 
 All notable changes to house land here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) from v0.1.0 onward.
 
-The publish workflow (`.github/workflows/publish.yml`) runs on the `release: published` event, builds per-platform binaries, publishes platform packages then the main package via Trusted Publisher, and lets GitHub auto-generate release notes from commit subjects; this file is the curated, narrative version.
+The publish workflow (`.github/workflows/publish.yml`) runs for a published release or a release-tag dispatch, builds per-platform binaries, publishes platform packages then the main package via Trusted Publisher, and lets GitHub auto-generate release notes from commit subjects; this file is the curated, narrative version.
 
 ## [Unreleased]
 
+## [0.9.0] — 2026-09-12
+
+### Changed
+
+- Opening a selected file now hides the Sidebar by default so the Reader gets the full pane; set
+  `autoHideSidebar = false` or use `--no-auto-hide-sidebar` to keep the two-pane view.
+- Release preparation now runs from a dispatchable GitHub workflow, and merging its PR creates and verifies the release, so publishing no longer depends on a clean local checkout or a long-running terminal.
+- The publish job no longer waits for a GitHub `npm` environment reviewer, so creating the GitHub Release (or a `main` dispatch) is enough to ship. The environment still allows only `v*` tags and `main`.
+- Empty CLI `--extensions` / `--show` again override file and env lists after the Effect 4.0.0-beta.107 bump, so an explicit empty allow-list still wins.
+- House now runs on OpenTUI 0.5.9, matching `@house/ui` and the current renderer/input stack.
+
+### Fixed
+
+- Release preparation now creates GitHub-verified commits, so release pull requests satisfy the
+  repository's signed-commit rule and can be merged normally.
+- Release preparation now rejects stale managed branches, requests maintainer review, and reports
+  dispatched CI on the pull request, so release approvals remain visible through GitHub and `gh`.
+- Release preparation now passes GitHub authentication and step outputs through Turborepo, so
+  dispatches can create release pull requests and start their CI.
+- Shift+A no longer drops a hidden-file selection when toggling hidden files back on, so the original file is reselected after the re-walk.
+- Theme resolution now keeps 8-digit hex alpha from bundled palettes, so muted and border tokens in themes like Cursor stay distinct from opaque text.
+
+
+## [0.8.0] — 2026-08-30
+
+### Added
+
+- `@house/options` specs may declare `footer: { icon, activate? }` so House can derive clickable footer controls from the catalog; wrap's `W` indicator now comes from that opt-in instead of a hard-coded Browser entry.
+- Footer `T` and `O` controls cycle theme and File Navigator browse order one step forward (with a short notice), so multi-value options are adjustable without leaving the keyboard-or-click chrome.
+- Choice footer controls show a declared short abbreviation of the current value (for example `op` / `re`) instead of a fixed letter, so the chip itself reflects state between Activate clicks.
+
+
 ## [0.7.0] — 2026-08-30
 
 ### Added
@@ -433,7 +465,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.7.0...HEAD
+[Unreleased]: https://github.com/carlesandres/house/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/carlesandres/house/compare/v0.8.0...v0.9.0
+[0.8.0]: https://github.com/carlesandres/house/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/carlesandres/house/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/carlesandres/house/compare/v0.5.2...v0.6.0
 [0.5.2]: https://github.com/carlesandres/house/compare/v0.5.1...v0.5.2

package/README.md

@@ -68,6 +68,8 @@ house --serve README.md
 | `--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                                                                          |
+| `--auto-hide-sidebar` | on               | Hide the sidebar after explicitly opening a file                                                             |
+| `--no-auto-hide-sidebar` | off           | Keep the sidebar visible after explicitly opening a file                                                     |
 | `--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                                                   |
 | `--focus <mode>`     | `sidebar`         | Startup focus: `sidebar`, `reader`, or `filter`. `filter` opens the sidebar filter prompt immediately.       |
@@ -97,27 +99,33 @@ tone  = "dark"
 extensions = []
 width = 80
 wrap = false
+autoHideSidebar = true
 show  = ["hidden", "gitignored"]
 focus = "sidebar"
 defaultRoot = "cwd" # or "git"
 order = "recently-modified" # or "tree"
 ```
 
-Supported keys: `theme`, `tone`, `extensions`, `width`, `wrap`, `show`, `focus`, `defaultRoot`, `order`.
+Supported keys: `theme`, `tone`, `extensions`, `width`, `wrap`, `autoHideSidebar`, `show`, `focus`, `defaultRoot`, `order`.
 
 `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`, `--width`, `--wrap`, `--no-wrap`, `--show`, `--focus`, `--order`, `--root`)
-2. Env vars (`HOUSE_THEME`, `HOUSE_TONE`, `HOUSE_EXTENSIONS`, `HOUSE_WIDTH`, `HOUSE_WRAP`, `HOUSE_SHOW`, `HOUSE_FOCUS`, `HOUSE_DEFAULT_ROOT`, `HOUSE_ORDER`)
+1. CLI flags (`--theme`, `--tone`, `--ext`, `--width`, `--wrap`, `--no-wrap`, `--auto-hide-sidebar`, `--no-auto-hide-sidebar`, `--show`, `--focus`, `--order`, `--root`)
+2. Env vars (`HOUSE_THEME`, `HOUSE_TONE`, `HOUSE_EXTENSIONS`, `HOUSE_WIDTH`, `HOUSE_WRAP`, `HOUSE_AUTO_HIDE_SIDEBAR`, `HOUSE_SHOW`, `HOUSE_FOCUS`, `HOUSE_DEFAULT_ROOT`, `HOUSE_ORDER`)
 3. Config file
-4. Built-in defaults (`opencode` / `dark` / `extensions = []` / `width = 80` / `wrap = false` / `show = []` / `focus = "sidebar"` / `defaultRoot = "cwd"` / `order = "recently-modified"`)
+4. Built-in defaults (`opencode` / `dark` / `extensions = []` / `width = 80` / `wrap = false` / `autoHideSidebar = true` / `show = []` / `focus = "sidebar"` / `defaultRoot = "cwd"` / `order = "recently-modified"`)
 
 `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.
 
+`autoHideSidebar` hides the sidebar when you explicitly open a selected file with `↵`, `→`, `l`,
+the command palette, or a matching filter Return. Selection movement still previews files without
+hiding it. Press `s` or `/` to bring the sidebar back. Set the option to `false` to retain the
+two-pane view after Open file.
+
 `order` is the File Navigator browse order when no filter query is active. `recently-modified` (default) lists the most recently updated files first, using filesystem modification time, then tree order for ties. `tree` lists files before directories, alphabetically within each group, so current-directory files appear before nested subtrees. An active filter still ranks by relevance first.
 
 The file is optional — a missing file is fine. Invalid keys, unknown themes, invalid `defaultRoot`, or malformed TOML fail loudly with a one-line error. Per-project config (`.house/config.toml`) and additional keys are deferred.
@@ -157,7 +165,7 @@ The footer only shows essential app controls (`W`, `q`, `tab`, `s`, `ctrl+p`) to
 | `G`                             | Last file                                                                                 |
 | `/`                             | Filter files (fuzzy match on path)                                                        |
 | `A`                             | Toggle hidden + gitignored entries (session-only; round-trips with the configured `show`) |
-| `↵` / `→` / `l`                 | Open file (focus reader)                                                                  |
+| `↵` / `→` / `l`                 | Open file (focus reader and auto-hide the sidebar when enabled)                           |
 
 ### Reader
 

package/dist/index.js

@@ -3066,7 +3066,7 @@ import { useState as useState6 } from "react";
 // package.json
 var package_default = {
   name: "@carlesandres/house",
-  version: "0.7.0",
+  version: "0.9.0",
   description: "TUI-first markdown reader on opentui",
   type: "module",
   license: "MIT",
@@ -3134,15 +3134,15 @@ var package_default = {
     "@carlesandres/house-linux-x64": "0.5.1"
   },
   dependencies: {
-    "@effect/atom-react": "4.0.0-beta.60",
-    "@opentui/core": "0.2.15",
-    "@opentui/react": "0.2.15",
+    "@effect/atom-react": "4.0.0-beta.107",
+    "@opentui/core": "0.5.9",
+    "@opentui/react": "0.5.9",
     "@parcel/watcher": "2.6.0",
     commander: "^14.0.3",
-    effect: "4.0.0-beta.60",
+    effect: "4.0.0-beta.107",
     ignore: "^7.0.5",
     marked: "^18.0.4",
-    react: "19.2.6",
+    react: "19.2.8",
     scheduler: "0.27.0",
     "string-width": "7.2.0",
     "web-tree-sitter": "0.25.10"
@@ -3150,7 +3150,7 @@ var package_default = {
   devDependencies: {
     "@effect/language-service": "0.86.2",
     "@types/bun": "1.3.14",
-    "@types/react": "19.2.15",
+    "@types/react": "19.2.18",
     emulate: "0.9.0",
     oxfmt: "0.51.0",
     oxlint: "1.66.0",
@@ -3162,6 +3162,279 @@ var package_default = {
 // src/Browser.tsx
 import { join as join4 } from "path";
 import { SyntaxStyle } from "@opentui/core";
+
+// ../../packages/options/src/footer.ts
+var footerActivate = (spec) => {
+  if (spec.footer?.activate !== undefined)
+    return spec.footer.activate;
+  if (spec.type === "boolean")
+    return "toggle";
+  if (spec.type === "string" && spec.choices !== undefined && spec.choices.length > 0) {
+    return "cycle";
+  }
+  return;
+};
+var footerKeys = (specs) => {
+  const keys = [];
+  for (const key of Object.keys(specs)) {
+    if (specs[key]?.footer !== undefined)
+      keys.push(key);
+  }
+  return keys;
+};
+var nextFooterValue = (spec, current) => {
+  const activate = footerActivate(spec);
+  if (activate === "toggle") {
+    if (spec.type !== "boolean") {
+      throw new Error('footer activate "toggle" requires a boolean option');
+    }
+    return !current;
+  }
+  if (activate === "cycle") {
+    if (spec.type !== "string" || spec.choices === undefined || spec.choices.length === 0) {
+      throw new Error('footer activate "cycle" requires a string option with choices');
+    }
+    const choices = spec.choices;
+    const currentIndex = choices.indexOf(current);
+    const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % choices.length;
+    return choices[nextIndex];
+  }
+  throw new Error("option has no footer activate strategy");
+};
+var footerControlActive = (spec, value) => {
+  if (spec.type === "boolean")
+    return Boolean(value);
+  return true;
+};
+var footerControlGlyph = (spec, value) => {
+  const footer = spec.footer;
+  if (footer === undefined) {
+    throw new Error("footerControlGlyph requires a footer-opted spec");
+  }
+  if (typeof value === "string" && footer.labels !== undefined) {
+    const label = footer.labels[value];
+    if (label !== undefined && label.length > 0)
+      return label;
+  }
+  return footer.icon;
+};
+var validateFooterSpecs = (specs) => {
+  for (const key of Object.keys(specs)) {
+    const spec = specs[key];
+    const footer = spec.footer;
+    if (footer === undefined)
+      continue;
+    if (footer.icon.length === 0) {
+      throw new Error(`option ${JSON.stringify(key)}: footer.icon must be non-empty`);
+    }
+    const activate = footerActivate(spec);
+    if (activate === undefined) {
+      throw new Error(`option ${JSON.stringify(key)}: footer requires activate "toggle" or "cycle" ` + "(booleans toggle; strings with choices cycle; other types need an explicit strategy)");
+    }
+    if (activate === "toggle" && spec.type !== "boolean") {
+      throw new Error(`option ${JSON.stringify(key)}: footer activate "toggle" requires type "boolean"`);
+    }
+    if (activate === "cycle") {
+      if (spec.type !== "string" || spec.choices === undefined || spec.choices.length === 0) {
+        throw new Error(`option ${JSON.stringify(key)}: footer activate "cycle" requires string choices`);
+      }
+      const labels = footer.labels;
+      if (labels === undefined) {
+        throw new Error(`option ${JSON.stringify(key)}: footer.labels is required for choice options`);
+      }
+      for (const choice of spec.choices) {
+        const label = labels[choice];
+        if (label === undefined || label.length === 0) {
+          throw new Error(`option ${JSON.stringify(key)}: footer.labels missing entry for ${JSON.stringify(choice)}`);
+        }
+      }
+    }
+  }
+};
+
+// ../../packages/options/src/decode.ts
+var isPresent = (value) => value !== undefined && value !== null;
+var stringifyReceived = (value) => {
+  if (typeof value === "string")
+    return JSON.stringify(value);
+  if (typeof value === "number" || typeof value === "boolean")
+    return JSON.stringify(value);
+  if (value === null)
+    return "null";
+  return typeof value;
+};
+var formatResolveError = (error, filePath) => {
+  if (error.layer === "file") {
+    const where = filePath === undefined ? "" : ` in ${filePath}`;
+    return `invalid value for ${error.key}${where}: ${error.message}`;
+  }
+  return `${error.key}: ${error.message}, got ${stringifyReceived(error.received)}`;
+};
+var fail = (key, layer, message, received) => ({
+  key,
+  layer,
+  message,
+  received
+});
+var booleanMessage = "expected true or false";
+var numberMessage = (spec) => {
+  if (spec.integer === true && spec.min === 1 && spec.max === undefined) {
+    return "expected a positive integer";
+  }
+  if (spec.integer === true)
+    return "expected an integer";
+  return "expected a number";
+};
+var inRange = (value, spec) => {
+  if (spec.min !== undefined && value < spec.min)
+    return false;
+  if (spec.max !== undefined && value > spec.max)
+    return false;
+  if (spec.integer === true && !Number.isSafeInteger(value))
+    return false;
+  if (!Number.isFinite(value))
+    return false;
+  return true;
+};
+var decodeBoolean = (key, layer, value) => {
+  if (layer === "env") {
+    if (value === "true")
+      return { ok: true, value: true };
+    if (value === "false")
+      return { ok: true, value: false };
+    return { ok: false, error: fail(key, layer, booleanMessage, value) };
+  }
+  if (typeof value === "boolean")
+    return { ok: true, value };
+  return { ok: false, error: fail(key, layer, booleanMessage, value) };
+};
+var decodeNumber = (key, layer, value, spec) => {
+  const message = numberMessage(spec);
+  if (layer === "env") {
+    if (typeof value !== "string" || !/^-?\d+(\.\d+)?$/.test(value)) {
+      return { ok: false, error: fail(key, layer, message, value) };
+    }
+    if (spec.integer === true && !/^-?\d+$/.test(value)) {
+      return { ok: false, error: fail(key, layer, message, value) };
+    }
+    const parsed = spec.integer === true ? Number.parseInt(value, 10) : Number.parseFloat(value);
+    if (!inRange(parsed, spec))
+      return { ok: false, error: fail(key, layer, message, value) };
+    return { ok: true, value: parsed };
+  }
+  if (typeof value !== "number" || !inRange(value, spec)) {
+    return { ok: false, error: fail(key, layer, message, value) };
+  }
+  return { ok: true, value };
+};
+var decodeString = (key, layer, value, spec) => {
+  if (typeof value !== "string") {
+    const message = spec.choices === undefined ? "expected a string" : `expected one of ${spec.choices.join(", ")}`;
+    return { ok: false, error: fail(key, layer, message, value) };
+  }
+  if (spec.choices !== undefined && !spec.choices.includes(value)) {
+    return {
+      ok: false,
+      error: fail(key, layer, `expected one of ${spec.choices.join(", ")}`, value)
+    };
+  }
+  return { ok: true, value };
+};
+var decodeValue = (key, spec, layer, value) => {
+  if (spec.type === "boolean")
+    return decodeBoolean(key, layer, value);
+  if (spec.type === "number")
+    return decodeNumber(key, layer, value, spec);
+  return decodeString(key, layer, value, spec);
+};
+
+// ../../packages/options/src/resolve.ts
+var LAYERS = ["cli", "env", "file"];
+var resolveOptions = (specs, layers = {}) => {
+  const values = {};
+  for (const key of Object.keys(specs)) {
+    const spec = specs[key];
+    let found = false;
+    for (const layer of LAYERS) {
+      const source = layers[layer];
+      if (source === undefined)
+        continue;
+      const raw = source[key];
+      if (!isPresent(raw))
+        continue;
+      const decoded = decodeValue(key, spec, layer, raw);
+      if (!decoded.ok)
+        return decoded;
+      values[key] = decoded.value;
+      found = true;
+      break;
+    }
+    if (!found)
+      values[key] = spec.default;
+  }
+  return { ok: true, value: values };
+};
+var catalogDefaults = (specs) => {
+  const values = {};
+  for (const key of Object.keys(specs))
+    values[key] = specs[key].default;
+  return values;
+};
+
+// ../../packages/options/src/session.ts
+var persistPolicy = (persist) => persist ?? "session";
+var createSession = (specs, values, options = {}) => {
+  let snapshot = values;
+  const listeners = new Set;
+  const get = (key) => snapshot[key];
+  const set = async (key, value) => {
+    const spec = specs[key];
+    if (spec === undefined) {
+      throw new Error(`unknown option ${JSON.stringify(key)}`);
+    }
+    const decoded = decodeValue(key, spec, "cli", value);
+    if (!decoded.ok) {
+      throw new Error(`${decoded.error.key}: ${decoded.error.message}`);
+    }
+    if (Object.is(snapshot[key], decoded.value))
+      return;
+    snapshot = { ...snapshot, [key]: decoded.value };
+    for (const listener of listeners)
+      listener(snapshot);
+    if (persistPolicy(spec.persist) === "file" && options.persist !== undefined) {
+      await options.persist({
+        key,
+        value: decoded.value,
+        values: snapshot
+      });
+    }
+  };
+  return {
+    get,
+    set,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    get values() {
+      return snapshot;
+    }
+  };
+};
+
+// ../../packages/options/src/define.ts
+var defineOptions = (specs) => {
+  validateFooterSpecs(specs);
+  return {
+    specs,
+    defaults: catalogDefaults(specs),
+    resolve: (layers) => resolveOptions(specs, layers),
+    createSession: (values, options) => createSession(specs, values, options)
+  };
+};
+// src/Browser.tsx
 import { useKeyboard, useRenderer, useTerminalDimensions as useTerminalDimensions2 } from "@opentui/react";
 import { useAtomValue, useAtomSet } from "@effect/atom-react";
 import { Effect as Effect3 } from "effect";
@@ -3347,7 +3620,7 @@ var browserBindings = [
     description: "Open file (focus reader)",
     keys: ["return", "right", "l"],
     when: inSidebar,
-    run: (c) => c.setFocus("reader")
+    run: (c) => c.openSelectedFile()
   },
   {
     id: "serve.current",
@@ -3572,17 +3845,16 @@ var HARD_FALLBACK_RAW = {
   syntaxPunctuation: "#D8DEE9"
 };
 var HEX_RE_INIT = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
-var lowerHex = (hex) => {
-  const v = hex.replace("#", "");
+var normalizeHex = (value) => {
+  const v = value.replace("#", "");
   const expanded = v.length === 3 || v.length === 4 ? v.split("").map((c) => c + c).join("") : v;
-  const rgb = expanded.length === 8 ? expanded.slice(0, 6) : expanded;
-  return `#${rgb.toLowerCase()}`;
+  return `#${expanded.toLowerCase()}`;
 };
 for (const v of Object.values(HARD_FALLBACK_RAW)) {
   if (!HEX_RE_INIT.test(v))
     throw new Error(`bad fallback hex: ${v}`);
 }
-var HARD_FALLBACK = Object.fromEntries(Object.entries(HARD_FALLBACK_RAW).map(([k, v]) => [k, lowerHex(v)]));
+var HARD_FALLBACK = Object.fromEntries(Object.entries(HARD_FALLBACK_RAW).map(([k, v]) => [k, normalizeHex(v)]));
 var TOKEN_FALLBACK = {
   selectedListItemText: "text",
   markdownText: "text",
@@ -3591,12 +3863,6 @@ var TOKEN_FALLBACK = {
 };
 var HEX_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
 var isHex = (value) => HEX_RE.test(value);
-var normalizeHex = (value) => {
-  const v = value.replace("#", "");
-  const expanded = v.length === 3 || v.length === 4 ? v.split("").map((c) => c + c).join("") : v;
-  const rgb = expanded.length === 8 ? expanded.slice(0, 6) : expanded;
-  return `#${rgb.toLowerCase()}`;
-};
 var resolveSide = (value, defs) => {
   if (isHex(value))
     return normalizeHex(value);
@@ -4090,7 +4356,7 @@ var BRAND = "\u2302";
 var BRAND_NAME = "house";
 
 // src/Footer.tsx
-import stringWidth from "string-width";
+import stringWidth2 from "string-width";
 
 // src/keymap/displayKey.ts
 var displayKey = (raw) => {
@@ -4145,7 +4411,9 @@ var Spinner = ({
 };
 
 // src/StatusIndicator.tsx
+import stringWidth from "string-width";
 import { jsxDEV as jsxDEV5 } from "@opentui/react/jsx-dev-runtime";
+var statusIndicatorWidth = (icon) => 2 + Math.max(1, stringWidth(icon));
 var statusIndicatorFg = (variant) => {
   switch (variant) {
     case "info":
@@ -4164,18 +4432,20 @@ var StatusIndicator = ({
   active = true,
   onMouseUp
 }) => {
+  const glyph = icon.toLocaleUpperCase();
   const activeColor = statusIndicatorFg(variant);
   const backgroundColor = active ? activeColor : colors.backgroundElement;
+  const width = statusIndicatorWidth(glyph);
   return /* @__PURE__ */ jsxDEV5("box", {
     ...onMouseUp === undefined ? {} : { onMouseUp },
     style: {
-      width: 3,
+      width,
       height: 1,
       flexDirection: "row",
       backgroundColor
     },
     children: /* @__PURE__ */ jsxDEV5("text", {
-      content: ` ${icon} `,
+      content: ` ${glyph} `,
       wrapMode: "none",
       style: {
         fg: active ? colors.backgroundPanel : colors.textMuted,
@@ -4191,7 +4461,7 @@ import { jsxDEV as jsxDEV6 } from "@opentui/react/jsx-dev-runtime";
 var FOOTER_HEIGHT = 1;
 var normalizeStatusLine = (status) => status.replace(/\s+/g, " ").trim();
 var HINT_SEPARATOR = "  ";
-var hintWidth = (h) => stringWidth(h.key) + 1 + stringWidth(h.label);
+var hintWidth = (h) => stringWidth2(h.key) + 1 + stringWidth2(h.label);
 var formatHint = (b) => {
   if (!b.hint)
     return null;
@@ -4218,6 +4488,8 @@ var fitHints = (hints, width) => {
   return [{ key: first.key.slice(0, width), label: "" }];
 };
 var STATUS_SEPARATOR = " \xB7 ";
+var INDICATOR_SEPARATOR = " ";
+var INDICATOR_SEPARATOR_WIDTH = 1;
 var NON_WARNING_STATUS_PREFIX_WIDTH = 2;
 var isPartialDiscoveryWarning = (status) => status?.startsWith("scan incomplete:") ?? false;
 var Footer = ({
@@ -4265,7 +4537,9 @@ var Footer = ({
     ] : [],
     ...indicators
   ];
-  const indicatorBudget = Math.min(usableWidth, renderedIndicators.length * 3);
+  const indicatorWidths = renderedIndicators.map((indicator) => statusIndicatorWidth(indicator.icon));
+  const indicatorSeparatorBudget = renderedIndicators.length > 1 ? (renderedIndicators.length - 1) * INDICATOR_SEPARATOR_WIDTH : 0;
+  const indicatorBudget = Math.min(usableWidth, indicatorWidths.reduce((sum, width2) => sum + width2, 0) + indicatorSeparatorBudget);
   const hasContentAfterIndicators = notice !== null || status !== null || hints.length > 0;
   const indicatorContentGapBudget = renderedIndicators.length > 0 && hasContentAfterIndicators && indicatorBudget < usableWidth ? 1 : 0;
   const contentBudget = Math.max(0, usableWidth - indicatorBudget - indicatorContentGapBudget);
@@ -4277,9 +4551,21 @@ var Footer = ({
   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 > contentBudget ? notice.slice(0, contentBudget) : notice : null;
-  const renderIndicators = () => renderedIndicators.map(({ id, ...props }) => /* @__PURE__ */ jsxDEV6(StatusIndicator, {
-    ...props
-  }, id, false, undefined, this));
+  const renderIndicators = () => renderedIndicators.flatMap(({ id, ...props }, index) => {
+    const chip = /* @__PURE__ */ jsxDEV6(StatusIndicator, {
+      ...props
+    }, id, false, undefined, this);
+    if (index === 0)
+      return [chip];
+    return [
+      /* @__PURE__ */ jsxDEV6("text", {
+        content: INDICATOR_SEPARATOR,
+        wrapMode: "none",
+        style: { fg: colors.textMuted }
+      }, `indicator-sep-${id}`, false, undefined, this),
+      chip
+    ];
+  });
   const renderIndicatorContentGap = () => indicatorContentGapBudget > 0 ? /* @__PURE__ */ jsxDEV6("text", {
     content: " ",
     wrapMode: "none",
@@ -12742,192 +13028,76 @@ var map = loadBundledThemes();
 var themeDefinitions = [...map.values()];
 var getThemeDefinition = (id) => map.get(id);
 
-// ../../packages/options/src/decode.ts
-var isPresent = (value) => value !== undefined && value !== null;
-var stringifyReceived = (value) => {
-  if (typeof value === "string")
-    return JSON.stringify(value);
-  if (typeof value === "number" || typeof value === "boolean")
-    return JSON.stringify(value);
-  if (value === null)
-    return "null";
-  return typeof value;
-};
-var formatResolveError = (error, filePath) => {
-  if (error.layer === "file") {
-    const where = filePath === undefined ? "" : ` in ${filePath}`;
-    return `invalid value for ${error.key}${where}: ${error.message}`;
-  }
-  return `${error.key}: ${error.message}, got ${stringifyReceived(error.received)}`;
-};
-var fail = (key, layer, message, received) => ({
-  key,
-  layer,
-  message,
-  received
-});
-var booleanMessage = "expected true or false";
-var numberMessage = (spec) => {
-  if (spec.integer === true && spec.min === 1 && spec.max === undefined) {
-    return "expected a positive integer";
-  }
-  if (spec.integer === true)
-    return "expected an integer";
-  return "expected a number";
-};
-var inRange = (value, spec) => {
-  if (spec.min !== undefined && value < spec.min)
-    return false;
-  if (spec.max !== undefined && value > spec.max)
-    return false;
-  if (spec.integer === true && !Number.isSafeInteger(value))
-    return false;
-  if (!Number.isFinite(value))
-    return false;
-  return true;
-};
-var decodeBoolean = (key, layer, value) => {
-  if (layer === "env") {
-    if (value === "true")
-      return { ok: true, value: true };
-    if (value === "false")
-      return { ok: true, value: false };
-    return { ok: false, error: fail(key, layer, booleanMessage, value) };
-  }
-  if (typeof value === "boolean")
-    return { ok: true, value };
-  return { ok: false, error: fail(key, layer, booleanMessage, value) };
-};
-var decodeNumber = (key, layer, value, spec) => {
-  const message = numberMessage(spec);
-  if (layer === "env") {
-    if (typeof value !== "string" || !/^-?\d+(\.\d+)?$/.test(value)) {
-      return { ok: false, error: fail(key, layer, message, value) };
-    }
-    if (spec.integer === true && !/^-?\d+$/.test(value)) {
-      return { ok: false, error: fail(key, layer, message, value) };
-    }
-    const parsed = spec.integer === true ? Number.parseInt(value, 10) : Number.parseFloat(value);
-    if (!inRange(parsed, spec))
-      return { ok: false, error: fail(key, layer, message, value) };
-    return { ok: true, value: parsed };
-  }
-  if (typeof value !== "number" || !inRange(value, spec)) {
-    return { ok: false, error: fail(key, layer, message, value) };
-  }
-  return { ok: true, value };
-};
-var decodeString = (key, layer, value, spec) => {
-  if (typeof value !== "string") {
-    const message = spec.choices === undefined ? "expected a string" : `expected one of ${spec.choices.join(", ")}`;
-    return { ok: false, error: fail(key, layer, message, value) };
-  }
-  if (spec.choices !== undefined && !spec.choices.includes(value)) {
-    return {
-      ok: false,
-      error: fail(key, layer, `expected one of ${spec.choices.join(", ")}`, value)
-    };
+// src/config/footerControls.ts
+var footerControlsFromSession = (options, session, handlers = {}) => {
+  const controls = [];
+  for (const key of footerKeys(options.specs)) {
+    const spec = options.specs[key];
+    const footer = spec.footer;
+    if (footer === undefined)
+      continue;
+    const value = session.get(key);
+    const handler = handlers[key];
+    controls.push({
+      id: key,
+      icon: footerControlGlyph(spec, value),
+      variant: "info",
+      active: handler?.active ?? footerControlActive(spec, value),
+      onMouseUp: () => {
+        if (handler?.onActivate !== undefined) {
+          handler.onActivate();
+          return;
+        }
+        const current = session.get(key);
+        session.set(key, nextFooterValue(spec, current));
+      }
+    });
   }
-  return { ok: true, value };
-};
-var decodeValue = (key, spec, layer, value) => {
-  if (spec.type === "boolean")
-    return decodeBoolean(key, layer, value);
-  if (spec.type === "number")
-    return decodeNumber(key, layer, value, spec);
-  return decodeString(key, layer, value, spec);
+  return controls;
 };
 
-// ../../packages/options/src/resolve.ts
-var LAYERS = ["cli", "env", "file"];
-var resolveOptions = (specs, layers = {}) => {
-  const values = {};
-  for (const key of Object.keys(specs)) {
-    const spec = specs[key];
-    let found = false;
-    for (const layer of LAYERS) {
-      const source = layers[layer];
-      if (source === undefined)
-        continue;
-      const raw = source[key];
-      if (!isPresent(raw))
-        continue;
-      const decoded = decodeValue(key, spec, layer, raw);
-      if (!decoded.ok)
-        return decoded;
-      values[key] = decoded.value;
-      found = true;
-      break;
+// src/config/footerLabels.ts
+var uniqueFooterLabels = (ids) => {
+  const used = new Set;
+  const out = {};
+  for (const id of ids) {
+    const compact = id.replace(/[^a-zA-Z0-9]+/g, "").toLowerCase();
+    const source = compact.length > 0 ? compact : "x";
+    let label = source.slice(0, 2).padEnd(2, "x");
+    let offset = 2;
+    while (used.has(label)) {
+      const next = source[offset];
+      if (next !== undefined) {
+        label = `${source[0]}${next}`;
+        offset += 1;
+      } else {
+        label = `${source[0]}${used.size % 10}`;
+        offset += 1;
+        if (offset > source.length + 20) {
+          throw new Error(`unable to allocate unique footer label for ${JSON.stringify(id)}`);
+        }
+      }
     }
-    if (!found)
-      values[key] = spec.default;
+    used.add(label);
+    out[id] = label;
   }
-  return { ok: true, value: values };
-};
-var catalogDefaults = (specs) => {
-  const values = {};
-  for (const key of Object.keys(specs))
-    values[key] = specs[key].default;
-  return values;
-};
-
-// ../../packages/options/src/session.ts
-var persistPolicy = (persist) => persist ?? "session";
-var createSession = (specs, values, options = {}) => {
-  let snapshot = values;
-  const listeners = new Set;
-  const get = (key) => snapshot[key];
-  const set = async (key, value) => {
-    const spec = specs[key];
-    if (spec === undefined) {
-      throw new Error(`unknown option ${JSON.stringify(key)}`);
-    }
-    const decoded = decodeValue(key, spec, "cli", value);
-    if (!decoded.ok) {
-      throw new Error(`${decoded.error.key}: ${decoded.error.message}`);
-    }
-    if (Object.is(snapshot[key], decoded.value))
-      return;
-    snapshot = { ...snapshot, [key]: decoded.value };
-    for (const listener of listeners)
-      listener(snapshot);
-    if (persistPolicy(spec.persist) === "file" && options.persist !== undefined) {
-      await options.persist({
-        key,
-        value: decoded.value,
-        values: snapshot
-      });
-    }
-  };
-  return {
-    get,
-    set,
-    subscribe: (listener) => {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    get values() {
-      return snapshot;
-    }
-  };
+  return out;
 };
 
-// ../../packages/options/src/define.ts
-var defineOptions = (specs) => ({
-  specs,
-  defaults: catalogDefaults(specs),
-  resolve: (layers) => resolveOptions(specs, layers),
-  createSession: (values, options) => createSession(specs, values, options)
-});
 // src/config/options.ts
 var FILE_NAVIGATOR_ORDERS = ["tree", "recently-modified"];
+var themeIds = themeDefinitions.map((theme) => theme.id);
+var themeFooterLabels = uniqueFooterLabels(themeIds);
 var houseOptions = defineOptions({
+  autoHideSidebar: {
+    type: "boolean",
+    default: true
+  },
   wrap: {
     type: "boolean",
     default: false,
-    persist: "session"
+    persist: "session",
+    footer: { icon: "W" }
   },
   width: {
     type: "number",
@@ -12939,7 +13109,8 @@ var houseOptions = defineOptions({
     type: "string",
     default: "opencode",
     persist: "file",
-    choices: themeDefinitions.map((theme) => theme.id)
+    choices: themeIds,
+    footer: { icon: "T", labels: themeFooterLabels }
   },
   tone: {
     type: "string",
@@ -12960,7 +13131,15 @@ var houseOptions = defineOptions({
   order: {
     type: "string",
     default: "recently-modified",
-    choices: FILE_NAVIGATOR_ORDERS
+    choices: FILE_NAVIGATOR_ORDERS,
+    persist: "session",
+    footer: {
+      icon: "O",
+      labels: {
+        tree: "tr",
+        "recently-modified": "re"
+      }
+    }
   }
 });
 
@@ -12996,6 +13175,7 @@ var parseShowList = (raw) => {
 var DEFAULT_EXTENSIONS = [];
 var DEFAULT_SHOW = "";
 var KNOWN_FILE_KEYS = new Set([
+  "autoHideSidebar",
   "theme",
   "tone",
   "extensions",
@@ -13010,7 +13190,8 @@ var schema = Config.all({
   extensions: Config.schema(Schema.String, "extensions"),
   show: Config.schema(Schema.String, "show")
 });
-var defaultsProvider = () => ConfigProvider.fromUnknown({
+var fromUnknown = (root) => ConfigProvider.fromUnknown(root, { preserveEmptyStrings: true });
+var defaultsProvider = () => fromUnknown({
   extensions: DEFAULT_EXTENSIONS.join(","),
   show: DEFAULT_SHOW
 });
@@ -13097,7 +13278,7 @@ var envProvider = (env) => {
     entries.push(["extensions", extensions]);
   if (show !== undefined)
     entries.push(["show", show]);
-  return ConfigProvider.fromUnknown(Object.fromEntries(entries));
+  return fromUnknown(Object.fromEntries(entries));
 };
 var cliProvider = (overrides) => {
   const entries = [];
@@ -13105,7 +13286,7 @@ var cliProvider = (overrides) => {
     entries.push(["extensions", overrides.extensions.join(",")]);
   if (overrides.show !== null)
     entries.push(["show", overrides.show.join(",")]);
-  return ConfigProvider.fromUnknown(Object.fromEntries(entries));
+  return fromUnknown(Object.fromEntries(entries));
 };
 var defaultConfigPath = () => join3(process.env["XDG_CONFIG_HOME"] ?? join3(homedir(), ".config"), "house", "config.toml");
 var formatConfigError = (err) => {
@@ -13120,6 +13301,7 @@ var formatConfigError = (err) => {
 };
 var loadConfig = (options = {}) => Effect2.gen(function* () {
   const cli = options.cli ?? {
+    autoHideSidebar: null,
     theme: null,
     tone: null,
     extensions: null,
@@ -13142,6 +13324,7 @@ var loadConfig = (options = {}) => Effect2.gen(function* () {
   }
   const resolved = houseOptions.resolve({
     cli: {
+      autoHideSidebar: cli.autoHideSidebar,
       wrap: cli.wrap,
       width: cli.width,
       theme: cli.theme,
@@ -13150,6 +13333,7 @@ var loadConfig = (options = {}) => Effect2.gen(function* () {
       order: cli.order
     },
     env: {
+      autoHideSidebar: env["HOUSE_AUTO_HIDE_SIDEBAR"],
       wrap: env["HOUSE_WRAP"],
       width: env["HOUSE_WIDTH"],
       theme: env["HOUSE_THEME"],
@@ -13159,6 +13343,7 @@ var loadConfig = (options = {}) => Effect2.gen(function* () {
       order: env["HOUSE_ORDER"]
     },
     file: {
+      autoHideSidebar: fileData?.["autoHideSidebar"],
       wrap: fileData?.["wrap"],
       width: fileData?.["width"],
       theme: fileData?.["theme"],
@@ -13188,6 +13373,7 @@ var loadConfig = (options = {}) => Effect2.gen(function* () {
     return yield* Effect2.fail(new Error(`order: expected one of ${FILE_NAVIGATOR_ORDERS.join(", ")}, got ${JSON.stringify(order)}`));
   }
   return {
+    autoHideSidebar: resolved.value.autoHideSidebar,
     theme: resolved.value.theme,
     tone,
     defaultRoot,
@@ -13297,6 +13483,7 @@ var persistHouseOption = async (event, path) => {
 
 // src/Browser.tsx
 import { jsxDEV as jsxDEV13 } from "@opentui/react/jsx-dev-runtime";
+var asFileNavigatorOrder = (value) => typeof value === "string" && FILE_NAVIGATOR_ORDERS.includes(value) ? value : "recently-modified";
 var defaultReadFile = (path) => Effect3.runPromise(readFileText(path));
 var defaultDiscoveryPolicy = {
   revision: "house-markdown",
@@ -13343,6 +13530,7 @@ var Browser = ({
   initialQuery = "",
   wrapWidth = 80,
   initialWrap = false,
+  initialAutoHideSidebar = true,
   rootLabel = "current root",
   discoveryStatus = null,
   discoverySpinnerIntervalMs,
@@ -13357,6 +13545,7 @@ var Browser = ({
   updateNotice = null,
   updateNoticeTtlMs = 1e4,
   disableFooterNoticeAutoClear = false,
+  onNavigatorIdle,
   onToggleAll,
   startupFocus = null,
   order = "recently-modified",
@@ -13376,17 +13565,20 @@ var Browser = ({
     optionsSession.current = houseOptions.createSession({
       ...houseOptions.defaults,
       wrap: initialWrap,
+      autoHideSidebar: initialAutoHideSidebar,
       width: wrapWidth,
       theme: theme.id,
-      tone: theme.tone
+      tone: theme.tone,
+      order: asFileNavigatorOrder(order)
     }, { persist: persistHouseOption });
   }
   const wrapEnabled = useSyncExternalStore(optionsSession.current.subscribe, () => optionsSession.current.get("wrap"));
+  const browseOrder = useSyncExternalStore(optionsSession.current.subscribe, () => asFileNavigatorOrder(optionsSession.current.get("order")));
   const toggleWrap = () => {
     const session = optionsSession.current;
     if (session === null)
       return;
-    session.set("wrap", !session.get("wrap"));
+    session.set("wrap", nextFooterValue(houseOptions.specs.wrap, session.get("wrap")));
   };
   const [loaded, setLoaded] = useState4(null);
   const [error, setError] = useState4(null);
@@ -13520,11 +13712,36 @@ var Browser = ({
   const paletteInputReadyRef = useRef3(false);
   const promptInputReadyRef = useRef3(false);
   const focusRef = useRef3(focus);
+  const autoHideSidebar = optionsSession.current.get("autoHideSidebar");
+  const openSelectedFile = () => {
+    if (autoHideSidebar && navigator2.getSnapshot().selectedFile !== null)
+      setShown(false);
+    focusRef.current = "reader";
+    setFocus("reader");
+  };
   const restoreFilterOnSidebarFocusRef = useRef3(startInFilter);
   const [footerNotice, setFooterNoticeState] = useState4(null);
   const pushFooterNotice = (text, ttlMs = 2000) => setFooterNoticeState({ text, ttlMs });
   const serverRef = useRef3(initialPreviewServer);
   const pendingSelectionPathRef = useRef3(null);
+  const pendingSelectionMissingRef = useRef3(false);
+  const clearPendingSelection = () => {
+    pendingSelectionPathRef.current = null;
+    pendingSelectionMissingRef.current = false;
+  };
+  const takePendingRestoreTarget = (files) => {
+    const target = pendingSelectionPathRef.current;
+    if (target === null)
+      return null;
+    const inList = files.some((file) => file.absolutePath === target);
+    if (!inList) {
+      pendingSelectionMissingRef.current = true;
+      return null;
+    }
+    if (!pendingSelectionMissingRef.current)
+      return null;
+    return target;
+  };
   useLayoutEffect3(() => {
     if (readerRootRef.current === root)
       return;
@@ -13574,6 +13791,15 @@ var Browser = ({
   useEffect4(() => {
     focusRef.current = focus;
   }, [focus]);
+  const onNavigatorIdleRef = useRef3(onNavigatorIdle);
+  onNavigatorIdleRef.current = onNavigatorIdle;
+  const navigatorIdleNotifiedRef = useRef3(false);
+  useEffect4(() => {
+    if (navigatorIdleNotifiedRef.current || liveSnapshot.scanning)
+      return;
+    navigatorIdleNotifiedRef.current = true;
+    onNavigatorIdleRef.current?.();
+  }, [liveSnapshot.scanning]);
   useEffect4(() => {
     if (!updateNotice)
       return;
@@ -13606,6 +13832,14 @@ var Browser = ({
     rememberAppearance(session.set("theme", next.id));
     pushFooterNotice(`theme: ${next.name}`);
   };
+  const cycleOrder = () => {
+    const session = optionsSession.current;
+    if (session === null)
+      return;
+    const next = nextFooterValue(houseOptions.specs.order, session.get("order"));
+    session.set("order", next);
+    pushFooterNotice(`order: ${next}`);
+  };
   const toggleTone = () => {
     const session = optionsSession.current;
     if (session === null)
@@ -13620,15 +13854,13 @@ var Browser = ({
   };
   const filterHasNoMatches = filterInput.length > 0 && displayedFiles.length === 0;
   useEffect4(() => {
-    const target = pendingSelectionPathRef.current;
+    const target = takePendingRestoreTarget(displayedFiles);
     if (target === null)
       return;
-    if (displayedFiles.some((file) => file.absolutePath === target)) {
-      const snapshot = navigator2.selectPath(target);
-      if (snapshot.selectedFile?.absolutePath !== target)
-        return;
-      pendingSelectionPathRef.current = null;
-    }
+    const snapshot = navigator2.selectPath(target);
+    if (snapshot.selectedFile?.absolutePath !== target)
+      return;
+    clearPendingSelection();
   }, [displayedFiles, liveSnapshot.files]);
   useEffect4(() => {
     if (liveSnapshot.scanning || initialIndexRef.current === 0)
@@ -13974,18 +14206,19 @@ var Browser = ({
     paletteOpen,
     wrapEnabled,
     setFocus,
+    openSelectedFile,
     moveSelectionBy: (delta) => {
-      pendingSelectionPathRef.current = null;
+      clearPendingSelection();
       newFileEditPathRef.current = null;
       navigator2.moveBy(delta);
     },
     selectFirst: () => {
-      pendingSelectionPathRef.current = null;
+      clearPendingSelection();
       newFileEditPathRef.current = null;
       navigator2.selectFirst();
     },
     selectLast: () => {
-      pendingSelectionPathRef.current = null;
+      clearPendingSelection();
       newFileEditPathRef.current = null;
       navigator2.selectLast();
     },
@@ -14042,6 +14275,7 @@ var Browser = ({
       const current = navigator2.getSnapshot().selectedFile;
       if (pendingSelectionPathRef.current === null && current) {
         pendingSelectionPathRef.current = current.absolutePath;
+        pendingSelectionMissingRef.current = false;
       }
       onToggleAll?.();
     },
@@ -14185,6 +14419,10 @@ var Browser = ({
         key.preventDefault();
         return;
       }
+      if (key.ctrl && !key.meta && key.name === "c") {
+        key.preventDefault();
+        return;
+      }
       if (!promptInputReadyRef.current) {
         if (key.name === "backspace" || key.name === "delete") {
           if (promptInputRef.current.length === 0)
@@ -14209,8 +14447,7 @@ var Browser = ({
         filterOpenRef.current = false;
         setFilterOpen(false);
         if (effectiveCommit) {
-          focusRef.current = "reader";
-          setFocus("reader");
+          openSelectedFile();
         } else {
           const nextFocus = shown ? "sidebar" : "reader";
           focusRef.current = nextFocus;
@@ -14326,15 +14563,11 @@ var Browser = ({
     width,
     notice: footerNotice?.text ?? null,
     discoveryStatus: effectiveDiscoveryStatus,
-    indicators: [
-      {
-        id: "wrap",
-        icon: "W",
-        variant: "info",
-        active: wrapEnabled,
-        onMouseUp: toggleWrap
-      }
-    ],
+    indicators: optionsSession.current === null ? [] : footerControlsFromSession(houseOptions, optionsSession.current, {
+      wrap: { onActivate: toggleWrap },
+      theme: { onActivate: () => cycleTheme(1) },
+      order: { onActivate: cycleOrder }
+    }),
     ...discoverySpinnerIntervalMs === undefined ? {} : { discoverySpinnerIntervalMs },
     ...discoverySpinnerInitialFrameIndex === undefined ? {} : { discoverySpinnerInitialFrameIndex },
     ...discoverySpinnerRegisterTick === undefined ? {} : { discoverySpinnerRegisterTick },
@@ -14369,7 +14602,7 @@ var Browser = ({
             root,
             policy,
             watch: watch2,
-            order,
+            order: browseOrder,
             debounceMs: filterDebounceMs,
             navigatorRef,
             snapshot: liveSnapshot,
@@ -14398,9 +14631,9 @@ var Browser = ({
                 if (!handle)
                   return;
                 const next = handle.getSnapshot();
-                const target = pendingSelectionPathRef.current;
-                if (target && next.filteredFiles.some((file) => file.absolutePath === target)) {
-                  pendingSelectionPathRef.current = null;
+                const target = takePendingRestoreTarget(next.filteredFiles);
+                if (target !== null) {
+                  clearPendingSelection();
                   setNavigatorSnapshot(handle.selectPath(target));
                   return;
                 }
@@ -14554,7 +14787,7 @@ var Browser = ({
 
 // src/cli/argv.ts
 import { Command } from "commander";
-var createProgram = () => new Command().allowUnknownOption(true).allowExcessArguments(true).exitOverride().helpOption(false).option("--theme [id]").option("--tone [mode]").option("--width [N]").option("--wrap").option("--no-wrap").option("--serve").option("--port [N]").option("--config-path").option("--no-update-check").option("--ext [list]").option("--focus [mode]").option("--order [mode]").option("--show [list]").option("--root [dir]").option("-h, --help").option("-v, --version").argument("[path]");
+var createProgram = () => new Command().allowUnknownOption(true).allowExcessArguments(true).exitOverride().helpOption(false).option("--theme [id]").option("--tone [mode]").option("--width [N]").option("--wrap").option("--no-wrap").option("--auto-hide-sidebar").option("--no-auto-hide-sidebar").option("--serve").option("--port [N]").option("--config-path").option("--no-update-check").option("--ext [list]").option("--focus [mode]").option("--order [mode]").option("--show [list]").option("--root [dir]").option("-h, --help").option("-v, --version").argument("[path]");
 var VALUE_FLAGS = new Set([
   "--theme",
   "--tone",
@@ -14573,6 +14806,8 @@ var BOOLEAN_FLAGS = new Set([
   "--no-update-check",
   "--wrap",
   "--no-wrap",
+  "--auto-hide-sidebar",
+  "--no-auto-hide-sidebar",
   "--help",
   "-h",
   "--version",
@@ -14603,6 +14838,8 @@ var parseArgv = (argv) => {
   const stringOrNull = (value) => typeof value === "string" ? value : null;
   const hasWrap = argv.includes("--wrap");
   const hasNoWrap = argv.includes("--no-wrap");
+  const hasAutoHideSidebar = argv.includes("--auto-hide-sidebar");
+  const hasNoAutoHideSidebar = argv.includes("--no-auto-hide-sidebar");
   return {
     path: typeof pathArg === "string" ? pathArg : null,
     root: stringOrNull(opts["root"]),
@@ -14611,6 +14848,8 @@ var parseArgv = (argv) => {
     width: stringOrNull(opts["width"]),
     wrap: hasWrap ? true : hasNoWrap ? false : null,
     wrapConflict: hasWrap && hasNoWrap,
+    autoHideSidebar: hasAutoHideSidebar ? true : hasNoAutoHideSidebar ? false : null,
+    autoHideSidebarConflict: hasAutoHideSidebar && hasNoAutoHideSidebar,
     serve: opts["serve"] === true,
     port: stringOrNull(opts["port"]),
     help: opts["help"] === true,
@@ -14636,6 +14875,8 @@ options:
   --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
+  --auto-hide-sidebar     hide the sidebar after opening a file (default)
+  --no-auto-hide-sidebar  keep the sidebar visible after opening a file
   --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)
@@ -14656,8 +14897,8 @@ examples:
 
 configuration:
   file: $XDG_CONFIG_HOME/house/config.toml  (default ~/.config/house/config.toml)
-	  keys: theme, tone, width, wrap, extensions, show, focus, defaultRoot, order
-	  env:  HOUSE_THEME, HOUSE_TONE, HOUSE_WIDTH, HOUSE_WRAP, HOUSE_EXTENSIONS, HOUSE_SHOW, HOUSE_FOCUS, HOUSE_DEFAULT_ROOT, HOUSE_ORDER
+	  keys: theme, tone, width, wrap, autoHideSidebar, extensions, show, focus, defaultRoot, order
+	  env:  HOUSE_THEME, HOUSE_TONE, HOUSE_WIDTH, HOUSE_WRAP, HOUSE_AUTO_HIDE_SIDEBAR, HOUSE_EXTENSIONS, HOUSE_SHOW, HOUSE_FOCUS, HOUSE_DEFAULT_ROOT, HOUSE_ORDER
   precedence (high \u2192 low): flags \u2192 env \u2192 file \u2192 defaults`;
 
 // src/cli/fast-exit.ts
@@ -14671,6 +14912,10 @@ var parseAndHandleFastExit = (argv) => {
     console.error("house: --wrap and --no-wrap cannot be used together");
     process.exit(2);
   }
+  if (args.autoHideSidebarConflict) {
+    console.error("house: --auto-hide-sidebar and --no-auto-hide-sidebar cannot be used together");
+    process.exit(2);
+  }
   if (argv.includes("--width") && args.width === null) {
     console.error("house: --width requires a positive integer");
     process.exit(2);
@@ -14996,6 +15241,7 @@ var DiscoverShell = ({
   extensions,
   wrapWidth,
   initialWrap,
+  initialAutoHideSidebar,
   startupFocus,
   order = "recently-modified"
 }) => {
@@ -15008,6 +15254,7 @@ var DiscoverShell = ({
     initialQuery,
     wrapWidth,
     initialWrap,
+    initialAutoHideSidebar,
     rootLabel,
     startupFocus,
     order,
@@ -15063,7 +15310,8 @@ async function main(argv = Bun.argv.slice(2)) {
         }
         return n;
       })(),
-      wrap: args.wrap
+      wrap: args.wrap,
+      autoHideSidebar: args.autoHideSidebar
     }
   })).catch((err) => {
     console.error(`house: ${formatConfigError(err)}`);
@@ -15078,6 +15326,7 @@ async function main(argv = Bun.argv.slice(2)) {
     defaultRoot,
     width: wrapWidth,
     wrap: initialWrap,
+    autoHideSidebar: initialAutoHideSidebar,
     order
   } = config;
   const themeDef = getThemeDefinition(themeId);
@@ -15133,6 +15382,7 @@ async function main(argv = Bun.argv.slice(2)) {
       tone,
       wrapWidth,
       initialWrap,
+      initialAutoHideSidebar,
       show,
       extensions,
       startupFocus,
@@ -15150,6 +15400,7 @@ async function runTui({
   tone,
   wrapWidth,
   initialWrap,
+  initialAutoHideSidebar,
   show,
   extensions,
   startupFocus,
@@ -15191,6 +15442,7 @@ async function runTui({
       extensions,
       wrapWidth,
       initialWrap,
+      initialAutoHideSidebar,
       startupFocus,
       order
     }, undefined, false, undefined, this)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@carlesandres/house",
-	"version": "0.7.0",
+	"version": "0.9.0",
 	"description": "TUI-first markdown reader on opentui",
 	"type": "module",
 	"license": "MIT",
@@ -62,21 +62,21 @@
 		"version:set": "bun run dev/set-version.ts"
 	},
 	"optionalDependencies": {
-		"@carlesandres/house-darwin-arm64": "0.7.0",
-		"@carlesandres/house-darwin-x64": "0.7.0",
-		"@carlesandres/house-linux-arm64": "0.7.0",
-		"@carlesandres/house-linux-x64": "0.7.0"
+		"@carlesandres/house-darwin-arm64": "0.9.0",
+		"@carlesandres/house-darwin-x64": "0.9.0",
+		"@carlesandres/house-linux-arm64": "0.9.0",
+		"@carlesandres/house-linux-x64": "0.9.0"
 	},
 	"dependencies": {
-		"@effect/atom-react": "4.0.0-beta.60",
-		"@opentui/core": "0.2.15",
-		"@opentui/react": "0.2.15",
+		"@effect/atom-react": "4.0.0-beta.107",
+		"@opentui/core": "0.5.9",
+		"@opentui/react": "0.5.9",
 		"@parcel/watcher": "2.6.0",
 		"commander": "^14.0.3",
-		"effect": "4.0.0-beta.60",
+		"effect": "4.0.0-beta.107",
 		"ignore": "^7.0.5",
 		"marked": "^18.0.4",
-		"react": "19.2.6",
+		"react": "19.2.8",
 		"scheduler": "0.27.0",
 		"string-width": "7.2.0",
 		"web-tree-sitter": "0.25.10"
@@ -84,7 +84,7 @@
 	"devDependencies": {
 		"@effect/language-service": "0.86.2",
 		"@types/bun": "1.3.14",
-		"@types/react": "19.2.15",
+		"@types/react": "19.2.18",
 		"emulate": "0.9.0",
 		"oxfmt": "0.51.0",
 		"oxlint": "1.66.0",