@carlesandres/house 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -2,10 +2,33 @@
 
 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
@@ -442,7 +465,8 @@ 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.8.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

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.8.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",
@@ -3620,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",
@@ -3845,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",
@@ -3864,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);
@@ -13096,6 +13089,10 @@ 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,
@@ -13178,6 +13175,7 @@ var parseShowList = (raw) => {
 var DEFAULT_EXTENSIONS = [];
 var DEFAULT_SHOW = "";
 var KNOWN_FILE_KEYS = new Set([
+  "autoHideSidebar",
   "theme",
   "tone",
   "extensions",
@@ -13192,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
 });
@@ -13279,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 = [];
@@ -13287,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) => {
@@ -13302,6 +13301,7 @@ var formatConfigError = (err) => {
 };
 var loadConfig = (options = {}) => Effect2.gen(function* () {
   const cli = options.cli ?? {
+    autoHideSidebar: null,
     theme: null,
     tone: null,
     extensions: null,
@@ -13324,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,
@@ -13332,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"],
@@ -13341,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"],
@@ -13370,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,
@@ -13526,6 +13530,7 @@ var Browser = ({
   initialQuery = "",
   wrapWidth = 80,
   initialWrap = false,
+  initialAutoHideSidebar = true,
   rootLabel = "current root",
   discoveryStatus = null,
   discoverySpinnerIntervalMs,
@@ -13540,6 +13545,7 @@ var Browser = ({
   updateNotice = null,
   updateNoticeTtlMs = 1e4,
   disableFooterNoticeAutoClear = false,
+  onNavigatorIdle,
   onToggleAll,
   startupFocus = null,
   order = "recently-modified",
@@ -13559,6 +13565,7 @@ var Browser = ({
     optionsSession.current = houseOptions.createSession({
       ...houseOptions.defaults,
       wrap: initialWrap,
+      autoHideSidebar: initialAutoHideSidebar,
       width: wrapWidth,
       theme: theme.id,
       tone: theme.tone,
@@ -13705,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;
@@ -13759,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;
@@ -13813,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)
@@ -14167,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();
     },
@@ -14235,6 +14275,7 @@ var Browser = ({
       const current = navigator2.getSnapshot().selectedFile;
       if (pendingSelectionPathRef.current === null && current) {
         pendingSelectionPathRef.current = current.absolutePath;
+        pendingSelectionMissingRef.current = false;
       }
       onToggleAll?.();
     },
@@ -14378,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)
@@ -14402,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;
@@ -14587,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;
                 }
@@ -14743,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",
@@ -14762,6 +14806,8 @@ var BOOLEAN_FLAGS = new Set([
   "--no-update-check",
   "--wrap",
   "--no-wrap",
+  "--auto-hide-sidebar",
+  "--no-auto-hide-sidebar",
   "--help",
   "-h",
   "--version",
@@ -14792,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"]),
@@ -14800,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,
@@ -14825,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)
@@ -14845,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
@@ -14860,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);
@@ -15185,6 +15241,7 @@ var DiscoverShell = ({
   extensions,
   wrapWidth,
   initialWrap,
+  initialAutoHideSidebar,
   startupFocus,
   order = "recently-modified"
 }) => {
@@ -15197,6 +15254,7 @@ var DiscoverShell = ({
     initialQuery,
     wrapWidth,
     initialWrap,
+    initialAutoHideSidebar,
     rootLabel,
     startupFocus,
     order,
@@ -15252,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)}`);
@@ -15267,6 +15326,7 @@ async function main(argv = Bun.argv.slice(2)) {
     defaultRoot,
     width: wrapWidth,
     wrap: initialWrap,
+    autoHideSidebar: initialAutoHideSidebar,
     order
   } = config;
   const themeDef = getThemeDefinition(themeId);
@@ -15322,6 +15382,7 @@ async function main(argv = Bun.argv.slice(2)) {
       tone,
       wrapWidth,
       initialWrap,
+      initialAutoHideSidebar,
       show,
       extensions,
       startupFocus,
@@ -15339,6 +15400,7 @@ async function runTui({
   tone,
   wrapWidth,
   initialWrap,
+  initialAutoHideSidebar,
   show,
   extensions,
   startupFocus,
@@ -15380,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.8.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.8.0",
-		"@carlesandres/house-darwin-x64": "0.8.0",
-		"@carlesandres/house-linux-arm64": "0.8.0",
-		"@carlesandres/house-linux-x64": "0.8.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",