@youtyan/code-viewer 0.2.9 → 0.2.11

package/README.md

@@ -27,8 +27,9 @@ Requires Node.js 20 or newer when installed from npm. Development uses
   viewer.
 - Browse SQLite, PostgreSQL, MySQL, Redis, Elasticsearch, and S3-compatible
   object storage (MinIO, LocalStack) with a built-in datastore viewer.
-- Read the built-in Help page for repository browsing, diffs, annotations,
-  the datastore viewer, agent skills, and shortcuts.
+- Read the built-in Help page for getting started, the `.code-viewer/`
+  project files, AI annotations, datastores, the agent skill, and
+  keybindings.
 - Open repository folders (and parent folders of files) in the OS file
   manager, create folders, and trash/restore files from localhost-only
   actions.
@@ -115,7 +116,9 @@ rendered, and the page includes controls to copy the full file or reopen it in
 the full non-virtual view.
 
 The worktree is watched and changes are pushed to every open tab over SSE so
-files reload as you edit. When the OS file-watch limit is reached the viewer
+files reload as you edit. The directory watcher is capped at 1024 directories
+by default and can be tuned from Viewer Settings → **File change watcher**
+(range slider + numeric input, 16–65536); when the cap is hit the viewer
 shows a banner so reloads are not silently missed.
 
 Large repositories load folder children on demand. The sidebar remembers which
@@ -129,13 +132,15 @@ views remain read-only. Open **Viewer Settings** in the header to toggle
 uploads off, edit the directories to skip while browsing/searching, and hide
 files or directory names completely.
 
-Scope settings control recursive repository browsing and search scope for the
-left tree, Ctrl+K file palette, and Ctrl+G grep palette. Everything you change
-in Viewer Settings is saved on the server under `.code-viewer/settings.json`
-(no separate project-level config file). `.DS_Store` and a small set of
+Scope settings control directory exclusions shared by the sidebar, Ctrl+K file
+palette, Ctrl+G grep palette, the Datastores browser, and the file change
+watcher — the same list applies to all five. Everything you change in Viewer
+Settings is saved on the server under `.code-viewer/settings.json` (no
+separate project-level config file). `.DS_Store` and a broad set of
 build/cache directories (`node_modules`, `dist`, `build`, `.next`, `.turbo`,
-`.venv`, …) are hidden by default. Pass `--scope-omit-dir <name>` (repeatable)
-to override the omit list on the command line for one session.
+`.parcel-cache`, `.vite`, `.angular`, `.dart_tool`, `.venv`, …) are hidden by
+default. Pass `--scope-omit-dir <name>` (repeatable) to override the omit
+list on the command line for one session.
 
 The viewer keeps its per-project state under `.code-viewer/` at the repository
 root:
@@ -235,9 +240,10 @@ Open Datastores in the global navigation to access:
 
 ### CLI
 
-AI agents can read data and query history from the command line. The current
-CLI ships `exec`, `list`, and `clear`; search, snapshot, and diff operations
-are performed from the browser UI.
+AI agents can run read-only queries, search content across tables, and
+capture snapshots / diffs from the command line. The same operations are
+mirrored under the Datastores tab in the browser UI, and every CLI result is
+written to the per-repository history visible in the browser.
 
 ```sh
 code-viewer query exec --db data.db --sql "SELECT * FROM users LIMIT 10" \
@@ -248,6 +254,22 @@ code-viewer query exec --db app.db --sql "SELECT count(*) FROM orders" \
 
 code-viewer query list --db app.db --json
 code-viewer query clear --db app.db
+
+code-viewer query search --db app.db --term "john@example.com" \
+    --tables users,orders --include-non-text --max-hits 20
+
+code-viewer query snapshot create --db app.db --tables users,orders \
+    --note "Before user registration test"
+code-viewer query snapshot list --db app.db --json
+code-viewer query snapshot note --id snap-abc123 --note "Updated context"
+code-viewer query snapshot delete --id snap-abc123
+
+code-viewer query diff create --before snap-abc123 --after snap-def456 \
+    --note "User registration test"
+code-viewer query diff tables --id diff-xyz789
+code-viewer query diff rows --id diff-xyz789 --table users --type inserted
+code-viewer query diff list --db app.db --json
+code-viewer query diff delete --id diff-xyz789
 ```
 
 `code-viewer query --help` shows all command syntax. `code-viewer query
@@ -303,9 +325,9 @@ with `--include-non-text` and `--run-search`. For AI agents,
 
 Annotations are grouped into sessions and persisted in
 `.code-viewer/annotations.json` at the repository root, so the walkthrough
-survives reloads and server restarts. The `.code-viewer` directory is
-tool-internal: it never shows up in the file tree, searches, or diffs. Add it
-to `.gitignore` if you do not want to share annotations through git.
+survives reloads and server restarts. See **Uploads and Scope Settings**
+above for how `.code-viewer/` is treated by the viewer and how to opt out of
+sharing it through git.
 
 In the browser, the annotation icon in the header opens the side panel. The
 current explanation is rendered at the top of the panel while the code stays
@@ -337,9 +359,11 @@ write concise Markdown explanations, and how to install the bundled agent skill.
 
 ### Agent Skill
 
-The package bundles [Agent Skills](https://agentskills.io) (the SKILL.md
-open standard) that teach AI coding agents when and how to use
-`annotate`, `query`, and `snapshot`. Install them into the current project:
+The package bundles three [Agent Skills](https://agentskills.io)
+(the SKILL.md open standard) — `code-viewer-annotate`, `code-viewer-query`,
+and `code-viewer-snapshot` — that teach AI coding agents when and how to use
+`annotate`, read-only `query`, and snapshot / diff workflows. A single
+`skill install` copies all three into the selected agent directories:
 
 ```sh
 npx -y @youtyan/code-viewer skill install                       # Claude Code (.claude/skills/)

package/dist/code-viewer.js

@@ -1514,6 +1514,7 @@ var init_git = __esm(() => {
   init_runtime();
   DEFAULT_WORKTREE_OMIT_DIR_NAMES = [
     "node_modules",
+    "bower_components",
     ".venv",
     "venv",
     ".next",
@@ -1521,6 +1522,11 @@ var init_git = __esm(() => {
     ".svelte-kit",
     ".astro",
     ".vercel",
+    ".angular",
+    ".docusaurus",
+    ".expo",
+    ".dart_tool",
+    ".serverless",
     "dist",
     "build",
     "out",
@@ -1528,6 +1534,9 @@ var init_git = __esm(() => {
     ".gradle",
     ".pnpm-store",
     ".turbo",
+    ".parcel-cache",
+    ".vite",
+    ".webpack",
     "__pycache__",
     ".pytest_cache",
     ".tox",
@@ -1537,6 +1546,7 @@ var init_git = __esm(() => {
     "vendor",
     ".cache",
     "coverage",
+    ".nyc_output",
     "tmp",
     "log",
     "storage",
@@ -2765,7 +2775,7 @@ __export(exports_skill_cli, {
   SKILL_HELP: () => SKILL_HELP,
   AGENT_SKILL_DIRS: () => AGENT_SKILL_DIRS
 });
-import { cpSync, existsSync as existsSync4, mkdirSync as mkdirSync2 } from "node:fs";
+import { cpSync, existsSync as existsSync4, mkdirSync as mkdirSync2, readdirSync as readdirSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join5, resolve } from "node:path";
 function parseAgentList(value) {
@@ -2821,25 +2831,34 @@ function parseSkillArgs(argv) {
   }
   return { ok: true, args: { kind: "install", agents, global, cwd } };
 }
+function discoverBundledSkills(skillsRoot) {
+  if (!existsSync4(skillsRoot))
+    return [];
+  return readdirSync2(skillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && existsSync4(join5(skillsRoot, entry.name, "SKILL.md"))).map((entry) => entry.name).sort();
+}
 function installSkill(args, deps) {
-  if (!existsSync4(join5(deps.sourceDir, "SKILL.md"))) {
+  const skills = discoverBundledSkills(deps.skillsRoot);
+  if (skills.length === 0) {
     return {
       ok: false,
-      error: `bundled skill not found at ${deps.sourceDir}`
+      error: `no bundled skills found under ${deps.skillsRoot}`
     };
   }
   const base = args.global ? deps.homeDir : resolve(args.cwd ?? deps.projectDir);
   const results = [];
   for (const agent of args.agents) {
-    const target = join5(base, AGENT_SKILL_DIRS[agent], "skills", SKILL_NAME);
-    const action = existsSync4(target) ? "updated" : "installed";
-    try {
-      mkdirSync2(target, { recursive: true });
-      cpSync(deps.sourceDir, target, { recursive: true });
-    } catch (error) {
-      return { ok: false, error: String(error) };
+    for (const skill of skills) {
+      const sourceDir = join5(deps.skillsRoot, skill);
+      const target = join5(base, AGENT_SKILL_DIRS[agent], "skills", skill);
+      const action = existsSync4(target) ? "updated" : "installed";
+      try {
+        mkdirSync2(target, { recursive: true });
+        cpSync(sourceDir, target, { recursive: true });
+      } catch (error) {
+        return { ok: false, error: String(error) };
+      }
+      results.push({ agent, skill, action, target });
     }
-    results.push({ agent, action, target });
   }
   return { ok: true, results };
 }
@@ -2855,7 +2874,7 @@ function runSkillCli(argv) {
     return;
   }
   const result = installSkill(parsed.args, {
-    sourceDir: join5(ROOT, "skills", SKILL_NAME),
+    skillsRoot: join5(ROOT, "skills"),
     homeDir: homedir2(),
     projectDir: process.cwd()
   });
@@ -2864,13 +2883,13 @@ function runSkillCli(argv) {
     process.exit(1);
   }
   for (const entry of result.results) {
-    console.log(`${entry.action} (${entry.agent}): ${entry.target}`);
+    console.log(`${entry.action} (${entry.agent}/${entry.skill}): ${entry.target}`);
   }
   if (result.results.some((entry) => entry.action === "installed")) {
-    console.log("Re-run the same command anytime to update the skill.");
+    console.log("Re-run the same command anytime to update the skills.");
   }
 }
-var SKILL_NAME = "code-viewer-annotate", AGENT_SKILL_DIRS, AGENT_NAMES, SKILL_HELP;
+var AGENT_SKILL_DIRS, AGENT_NAMES, SKILL_HELP;
 var init_skill_cli = __esm(() => {
   init_root();
   AGENT_SKILL_DIRS = {
@@ -2881,15 +2900,16 @@ var init_skill_cli = __esm(() => {
     agents: ".agents"
   };
   AGENT_NAMES = Object.keys(AGENT_SKILL_DIRS);
-  SKILL_HELP = `code-viewer skill — manage the bundled agent skill
+  SKILL_HELP = `code-viewer skill — manage the bundled agent skills
 
 Usage:
   code-viewer skill install [--agent <list>] [--global] [--cwd <dir>]
 
-Installs the ${SKILL_NAME} skill (SKILL.md for AI coding agents) into the
-skills directory of each selected agent in the current project, or into the
-home directory equivalents with --global. Running install again overwrites
-the files, so the same command also updates an existing installation.
+Installs every bundled skill (each SKILL.md directory under the package's
+skills/) into the skills directory of each selected agent in the current
+project, or into the home directory equivalents with --global. Running
+install again overwrites the files, so the same command also updates an
+existing installation.
 
 Options:
   --agent <list>  comma separated agents: ${AGENT_NAMES.join(", ")}, or all
@@ -4410,7 +4430,7 @@ function startWorktreeUpdateWatch(options) {
   watchDirectory(options.root, true);
   return { started: watchers.size > 0, close: closeAll };
 }
-var DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT = 256;
+var DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT = 1024, MIN_WORKTREE_WATCH_DIRECTORY_LIMIT = 1, MAX_WORKTREE_WATCH_DIRECTORY_LIMIT = 65536;
 var init_worktree_watcher = __esm(() => {
   init_search();
 });
@@ -11382,6 +11402,7 @@ Examples:
   if (scopeOmitDirCliOverride) {
     scopeOmitDirNames = scopeOmitDirCliOverride;
   }
+  scopeWatchLimit = worktreeWatchDirectoryLimitFromEnv();
 }
 function warnIfLegacyConfigPresent() {
   try {
@@ -11391,6 +11412,9 @@ function warnIfLegacyConfigPresent() {
   } catch {}
 }
 function applyPersistedSettings(state) {
+  const prevOmit = scopeOmitDirNames;
+  const prevExclude = scopeExcludeNames;
+  const prevWatchLimit = scopeWatchLimit;
   if (!scopeOmitDirCliOverride && Array.isArray(state.scopeOmitDirs) && state.scopeOmitDirs.length > 0) {
     scopeOmitDirNames = state.scopeOmitDirs;
   } else if (!scopeOmitDirCliOverride) {
@@ -11401,7 +11425,26 @@ function applyPersistedSettings(state) {
   } else {
     scopeExcludeNames = DEFAULT_EXCLUDE_NAMES;
   }
+  if (state.scopeWatchLimit != null) {
+    scopeWatchLimit = normalizeScopeWatchLimit(state.scopeWatchLimit);
+  }
   uploadEnabled = state.uploadEnabled !== false;
+  if (prevOmit !== scopeOmitDirNames || prevExclude !== scopeExcludeNames || prevWatchLimit !== scopeWatchLimit) {
+    restartWorktreeWatch();
+  }
+}
+function normalizeScopeWatchLimit(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  }
+  const floored = Math.floor(value);
+  if (floored < MIN_WORKTREE_WATCH_DIRECTORY_LIMIT) {
+    return MIN_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  }
+  if (floored > MAX_WORKTREE_WATCH_DIRECTORY_LIMIT) {
+    return MAX_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  }
+  return floored;
 }
 function json2(data, init = {}) {
   return new Response(JSON.stringify(data), {
@@ -11883,7 +11926,11 @@ function handleSettings() {
       omit_dirs_built_in: DEFAULT_WORKTREE_OMIT_DIR_NAMES,
       exclude_names_effective: scopeExcludeNames,
       exclude_names_built_in: DEFAULT_EXCLUDE_NAMES,
-      max_entries: WORKTREE_RECURSIVE_ENTRY_LIMIT
+      max_entries: WORKTREE_RECURSIVE_ENTRY_LIMIT,
+      watch_limit_effective: scopeWatchLimit,
+      watch_limit_default: DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT,
+      watch_limit_min: MIN_WORKTREE_WATCH_DIRECTORY_LIMIT,
+      watch_limit_max: MAX_WORKTREE_WATCH_DIRECTORY_LIMIT
     }
   });
 }
@@ -11892,7 +11939,14 @@ function worktreeWatchDirectoryLimitFromEnv() {
   if (!raw)
     return DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT;
   const parsed = Number(raw);
-  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  if (!Number.isFinite(parsed) || parsed <= 0)
+    return DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  const floored = Math.floor(parsed);
+  if (floored < MIN_WORKTREE_WATCH_DIRECTORY_LIMIT)
+    return MIN_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  if (floored > MAX_WORKTREE_WATCH_DIRECTORY_LIMIT)
+    return MAX_WORKTREE_WATCH_DIRECTORY_LIMIT;
+  return floored;
 }
 function handleFiles2(url) {
   const target = url.searchParams.get("ref") || url.searchParams.get("target") || "worktree";
@@ -13033,7 +13087,43 @@ async function shutdown(exitCode = 0) {
   }
   process.exit(exitCode);
 }
-var WEB_ROOT, VERSION, DEFAULT_ARGS, PREVIEW_HUNKS_DEFAULT = 3, PREVIEW_LINES_DEFAULT = 1200, WATCHED_ASSET_FILES, SIZE_SMALL = 2000, SIZE_MEDIUM = 8000, SIZE_LARGE = 20000, LINE_INDEX_MIN_START = 1e4, LINE_INDEX_MAX_FILE_BYTES, BLOB_LINE_CACHE_MAX_BYTES, MAX_UPLOAD_FILE_BYTES, MAX_UPLOAD_TOTAL_BYTES, MAX_UPLOAD_BODY_BYTES, MAX_UPLOAD_FILES = 50, SAFE_UPLOAD_EXTENSIONS, generation = 1, cwd, cliArgs, listenPort = 0, openAfterStart = false, scopeOmitDirNames, scopeOmitDirCliOverride = null, scopeExcludeNames, uploadEnabled = true, rgAvailableCache = null, enc, sseClients, sseKeepalives, fileCache, metaCache, fileListCache, lineIndexCache, blobLineIndexCache, blobBytesCache, blobLineCacheBytes = 0, isCodeViewerInternalPath, watchLimitReached = null, server, worktreeWatch = null, shuttingDown = false;
+function startScopedWorktreeWatch() {
+  watchLimitReached = null;
+  return startWorktreeUpdateWatch({
+    root: cwd,
+    omitDirNames: scopeOmitDirNames,
+    excludeNames: scopeExcludeNames,
+    watch,
+    initialScanMode: "async",
+    maxWatchedDirectories: scopeWatchLimit,
+    onUpdate: triggerUpdate,
+    onWatchLimit: (limit) => {
+      watchLimitReached = limit;
+      sendSse("watch-limit", String(limit));
+    },
+    onError: (error) => {
+      const message = error instanceof Error ? error.message : String(error);
+      console.warn(`code-viewer worktree watch skipped: ${message}`);
+    }
+  });
+}
+function restartWorktreeWatch() {
+  try {
+    if (shuttingDown)
+      return;
+    if (!worktreeWatch)
+      return;
+  } catch {
+    return;
+  }
+  try {
+    worktreeWatch.close();
+  } catch (error) {
+    console.warn(`code-viewer worktree watch restart close skipped: ${String(error)}`);
+  }
+  worktreeWatch = startScopedWorktreeWatch();
+}
+var WEB_ROOT, VERSION, DEFAULT_ARGS, PREVIEW_HUNKS_DEFAULT = 3, PREVIEW_LINES_DEFAULT = 1200, WATCHED_ASSET_FILES, SIZE_SMALL = 2000, SIZE_MEDIUM = 8000, SIZE_LARGE = 20000, LINE_INDEX_MIN_START = 1e4, LINE_INDEX_MAX_FILE_BYTES, BLOB_LINE_CACHE_MAX_BYTES, MAX_UPLOAD_FILE_BYTES, MAX_UPLOAD_TOTAL_BYTES, MAX_UPLOAD_BODY_BYTES, MAX_UPLOAD_FILES = 50, SAFE_UPLOAD_EXTENSIONS, generation = 1, cwd, cliArgs, listenPort = 0, openAfterStart = false, scopeOmitDirNames, scopeOmitDirCliOverride = null, scopeExcludeNames, scopeWatchLimit, uploadEnabled = true, rgAvailableCache = null, enc, sseClients, sseKeepalives, fileCache, metaCache, fileListCache, lineIndexCache, blobLineIndexCache, blobBytesCache, blobLineCacheBytes = 0, isCodeViewerInternalPath, watchLimitReached = null, server, worktreeWatch = null, shuttingDown = false;
 var init_preview = __esm(async () => {
   init_routes();
   init_annotations();
@@ -13096,6 +13186,7 @@ var init_preview = __esm(async () => {
   cliArgs = DEFAULT_ARGS;
   scopeOmitDirNames = DEFAULT_WORKTREE_OMIT_DIR_NAMES;
   scopeExcludeNames = DEFAULT_EXCLUDE_NAMES;
+  scopeWatchLimit = DEFAULT_WORKTREE_WATCH_DIRECTORY_LIMIT;
   enc = new TextEncoder;
   sseClients = new Set;
   sseKeepalives = new Map;
@@ -13248,23 +13339,7 @@ data: ${watchLimitReached}
     watch,
     sendReload: () => sendSse("reload")
   });
-  worktreeWatch = startWorktreeUpdateWatch({
-    root: cwd,
-    omitDirNames: scopeOmitDirNames,
-    excludeNames: scopeExcludeNames,
-    watch,
-    initialScanMode: "async",
-    maxWatchedDirectories: worktreeWatchDirectoryLimitFromEnv(),
-    onUpdate: triggerUpdate,
-    onWatchLimit: (limit) => {
-      watchLimitReached = limit;
-      sendSse("watch-limit", String(limit));
-    },
-    onError: (error) => {
-      const message = error instanceof Error ? error.message : String(error);
-      console.warn(`code-viewer worktree watch skipped: ${message}`);
-    }
-  });
+  worktreeWatch = startScopedWorktreeWatch();
   console.log(`GDP_LISTEN_URL=http://127.0.0.1:${server.port}/`);
   console.log(`git-diff-preview serving ${cwd}`);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youtyan/code-viewer",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Local browser-based code and git diff viewer",
   "type": "module",
   "bin": {

package/web/app.js

@@ -18383,6 +18383,7 @@ ${frontmatter.yaml}
   var HELP_LANGUAGES = ["en", "ja"];
   var HELP_SECTIONS = [
     "overview",
+    "storage",
     "annotations",
     "database",
     "skills",
@@ -18461,6 +18462,73 @@ ${frontmatter.yaml}
             }
           ]
         },
+        storage: {
+          nav: "Project Files",
+          title: ".code-viewer Directory",
+          intro: "code-viewer keeps every per-repository state file under .code-viewer/ at the root of the opened repository. The directory is created on demand, can be deleted at any time to reset state, and should be gitignored in most projects.",
+          groups: [
+            {
+              title: "What lives there",
+              blocks: [
+                {
+                  kind: "table",
+                  rows: [
+                    [
+                      "settings.json",
+                      "Viewer Settings — diff layout, theme, language, sidebar/history widths, font sizes, syntax highlight, ignore-whitespace, hide-tests, scope overrides (omitted dirs / excluded names), upload toggle, annotation panel open/follow/mute/rate, and the last viewed diff range."
+                    ],
+                    [
+                      "view-state.json",
+                      "Sidebar tree state — collapsed directories, lazy-expanded directories (folders opened on demand in large repos), and the viewed-file list used to dim already-read entries."
+                    ],
+                    [
+                      "tabs.json",
+                      "Multi-DB tab layout — open datastore tabs, the active tab, per-tab selected table / view / SQL draft, per-tab Elasticsearch index and Redis DB index, and per-tab sidebar and history panel widths."
+                    ],
+                    [
+                      "db-ui.json",
+                      "Datastore UI preferences — column widths per (DB, table, column) and toggle states such as Rails FK inference and the S3 tooltip."
+                    ],
+                    [
+                      "annotations.json",
+                      "AI annotation walkthroughs — sessions with their ordered steps (file, line range, title, body), used by the annotation panel and synced live to open tabs over SSE."
+                    ],
+                    [
+                      "query-history.json",
+                      "SQL query history — recent statements with column list, preview rows, row count, elapsed time, executor (browser or CLI), and execution timestamp."
+                    ],
+                    [
+                      "db-snapshots.sqlite (+ -shm / -wal)",
+                      "SQLite store used by the Datastore Snapshot tab to keep point-in-time captures of tables / indices / key spaces for diffing. The -shm / -wal sidecar files are SQLite WAL artifacts; do not edit them directly."
+                    ]
+                  ]
+                }
+              ]
+            },
+            {
+              title: "Source of truth and editing",
+              blocks: [
+                {
+                  kind: "paragraph",
+                  text: "Everything in .code-viewer/ is owned by code-viewer. JSON files are rewritten safely with validation on every change, so unknown keys are dropped and invalid values are reset to defaults. Hand-edit at your own risk — a corrupt file is renamed with a .corrupt suffix and replaced with an empty default."
+                },
+                {
+                  kind: "paragraph",
+                  text: "Deleting the whole directory is the supported way to reset all per-repository state. Removing a single file resets only that subsystem (for example, deleting tabs.json closes all DB tabs on the next load)."
+                }
+              ]
+            },
+            {
+              title: "Sharing across machines",
+              blocks: [
+                {
+                  kind: "paragraph",
+                  text: "These files contain local UI state and should normally stay out of version control — add .code-viewer/ to .gitignore. To share AI walkthroughs, commit annotations.json explicitly (or copy it between checkouts) and leave the other files ignored."
+                }
+              ]
+            }
+          ]
+        },
         annotations: {
           nav: "AI Annotations",
           title: "AI Code Annotations",
@@ -18683,7 +18751,7 @@ code-viewer annotate add-db --db app.db --tab query \\
               blocks: [
                 {
                   kind: "paragraph",
-                  text: "AI agents can execute read-only queries and manage per-DB query history from the CLI. Results are saved into the same history visible in the browser. Search, snapshot, and diff operations live in the browser UI (Search tab / Snapshot tab) rather than the CLI."
+                  text: "AI agents can execute read-only queries, search across tables, and capture snapshots / diffs from the CLI. Results are written to the same per-repository history visible in the browser, and the browser UI exposes the same operations through the Search tab and the Snapshot tab."
                 },
                 {
                   kind: "command",
@@ -18700,6 +18768,37 @@ code-viewer annotate add-db --db app.db --tab query \\
                   title: "List or clear query history",
                   command: `code-viewer query list --db app.db --json
 code-viewer query clear --db app.db`
+                },
+                {
+                  kind: "command",
+                  title: "Search across all tables",
+                  command: 'code-viewer query search --db app.db --term "john@example.com" \\\n  --tables users,orders --include-non-text --max-hits 20'
+                },
+                {
+                  kind: "command",
+                  title: "Capture a snapshot",
+                  command: 'code-viewer query snapshot create --db app.db --tables users,orders \\\n  --note "Before user registration test"'
+                },
+                {
+                  kind: "command",
+                  title: "List, annotate, or delete snapshots",
+                  command: `code-viewer query snapshot list --db app.db --json
+code-viewer query snapshot note --id snap-abc123 --note "Updated context"
+code-viewer query snapshot delete --id snap-abc123`
+                },
+                {
+                  kind: "command",
+                  title: "Diff two snapshots",
+                  command: `code-viewer query diff create --before snap-abc123 --after snap-def456 \\
+  --note "User registration test"
+code-viewer query diff list --db app.db --json
+code-viewer query diff delete --id diff-xyz789`
+                },
+                {
+                  kind: "command",
+                  title: "Inspect a diff",
+                  command: `code-viewer query diff tables --id diff-xyz789
+code-viewer query diff rows --id diff-xyz789 --table users --type inserted --limit 50`
                 },
                 {
                   kind: "command",
@@ -18713,10 +18812,10 @@ code-viewer query clear --db app.db`
         skills: {
           nav: "Agent Skill",
           title: "Agent Skill Setup",
-          intro: "The package includes a code-viewer annotate skill so AI agents know when and how to create browser walkthroughs.",
+          intro: "The package bundles three skills — code-viewer-annotate, code-viewer-query, and code-viewer-snapshot — so AI agents know when and how to create browser walkthroughs, run read-only queries, and capture snapshot / diff sessions. A single skill install command copies all three into the selected agent directories.",
           groups: [
             {
-              title: "Install the skill",
+              title: "Install the skills",
               blocks: [
                 {
                   kind: "command",
@@ -18738,11 +18837,17 @@ code-viewer query clear --db app.db`
                   kind: "command",
                   title: "Install globally for a user (not per project)",
                   command: "npx -y @youtyan/code-viewer skill install --agent all --global"
+                },
+                {
+                  kind: "command",
+                  title: "Install into a different project directory",
+                  command: `npx -y @youtyan/code-viewer skill install --agent all --cwd /path/to/other/repo
+# --cwd selects the target project; ignored when --global is also given.`
                 }
               ]
             },
             {
-              title: "What the skill teaches",
+              title: "What the skills teach",
               blocks: [
                 {
                   kind: "table",
@@ -18916,6 +19021,73 @@ code-viewer query clear --db app.db`
             }
           ]
         },
+        storage: {
+          nav: "プロジェクトファイル",
+          title: ".code-viewer ディレクトリ",
+          intro: "code-viewer はリポジトリ単位の状態をすべて、開いたリポジトリ直下の .code-viewer/ ディレクトリに保存します。必要になったときに自動で作られ、削除すれば全状態をリセットでき、通常は .gitignore に登録しておきます。",
+          groups: [
+            {
+              title: "中に置かれるファイル",
+              blocks: [
+                {
+                  kind: "table",
+                  rows: [
+                    [
+                      "settings.json",
+                      "Viewer Settings — diff レイアウト、テーマ、言語、サイドバー/履歴幅、フォントサイズ、シンタックスハイライト、whitespace 無視、テスト非表示、scope 上書き（除外ディレクトリ / 除外名）、アップロード許可、注釈パネルの開閉/follow/ミュート/再生速度、最後に表示した diff 範囲を保存します。"
+                    ],
+                    [
+                      "view-state.json",
+                      "サイドバーツリーの状態 — 折りたたみ済みディレクトリ、遅延展開済みディレクトリ（大規模リポジトリで必要に応じて開かれたフォルダ）、既読扱いするための表示済みファイル一覧。"
+                    ],
+                    [
+                      "tabs.json",
+                      "マルチ DB タブのレイアウト — 開いているデータストアタブ、アクティブタブ、タブごとの選択テーブル / ビュー / SQL ドラフト、Elasticsearch のインデックスや Redis の DB index、タブ単位のサイドバー幅・履歴パネル高。"
+                    ],
+                    [
+                      "db-ui.json",
+                      "データストア UI の設定 — (DB, テーブル, カラム) ごとの列幅、Rails FK 推測や S3 ツールチップなどのトグル状態。"
+                    ],
+                    [
+                      "annotations.json",
+                      "AI 注釈のウォークスルー — セッションと順序付きステップ（ファイル、行範囲、タイトル、本文）。注釈パネルが読み、SSE で開いているタブへもライブ同期されます。"
+                    ],
+                    [
+                      "query-history.json",
+                      "SQL クエリ履歴 — 直近のクエリ、カラム一覧、プレビュー行、行数、実行時間、実行元（browser / CLI）、実行時刻。"
+                    ],
+                    [
+                      "db-snapshots.sqlite (+ -shm / -wal)",
+                      "Snapshot タブが使う SQLite ストア。テーブル / インデックス / キー空間の時点スナップショットを保持し、差分表示に使います。-shm / -wal は SQLite の WAL 用付随ファイル。手動編集しないでください。"
+                    ]
+                  ]
+                }
+              ]
+            },
+            {
+              title: "ファイルの所有権と編集",
+              blocks: [
+                {
+                  kind: "paragraph",
+                  text: ".code-viewer/ の中身はすべて code-viewer が管理します。JSON ファイルは書き込みごとにバリデーションを通して安全に書き換えられるため、未知のキーは破棄され、不正な値は既定値に戻されます。手で編集すると壊れる可能性があり、壊れたファイルは .corrupt サフィックスに改名されて空の既定値で置き換えられます。"
+                },
+                {
+                  kind: "paragraph",
+                  text: "ディレクトリごと削除するのが、このリポジトリの全状態をリセットする推奨手順です。個別ファイルだけを消した場合はその系統だけがリセットされます（例: tabs.json を消すと次回起動時に DB タブがすべて閉じた状態になります）。"
+                }
+              ]
+            },
+            {
+              title: "他マシンとの共有",
+              blocks: [
+                {
+                  kind: "paragraph",
+                  text: "これらはローカル UI 状態なので、原則としてバージョン管理には入れません — .code-viewer/ を .gitignore に追加しておきます。AI のウォークスルーを共有したい場合は annotations.json だけを明示的に commit（または別チェックアウトへコピー）し、それ以外は無視したままにします。"
+                }
+              ]
+            }
+          ]
+        },
         annotations: {
           nav: "AI注釈",
           title: "AI コード注釈",
@@ -19138,7 +19310,7 @@ code-viewer annotate add-db --db app.db --tab query \\
               blocks: [
                 {
                   kind: "paragraph",
-                  text: "AI エージェントは CLI から read-only クエリの実行と per-DB クエリ履歴の管理ができます。結果はブラウザでも見える同じ履歴に保存されます。Search / Snapshot / Diff は CLI ではなくブラウザ UI の Search タブ / Snapshot タブから操作します。"
+                  text: "AI エージェントは CLI から read-only クエリの実行、テーブル横断検索、スナップショット / 差分作成までできます。結果はブラウザで見えるのと同じリポジトリ単位の履歴に保存され、ブラウザ UI 側でも Search タブ / Snapshot タブから同じ操作が行えます。"
                 },
                 {
                   kind: "command",
@@ -19152,9 +19324,40 @@ code-viewer annotate add-db --db app.db --tab query \\
                 },
                 {
                   kind: "command",
-                  title: "履歴の一覧/削除",
+                  title: "履歴の一覧 / 削除",
                   command: `code-viewer query list --db app.db --json
 code-viewer query clear --db app.db`
+                },
+                {
+                  kind: "command",
+                  title: "テーブル横断の全文検索",
+                  command: 'code-viewer query search --db app.db --term "john@example.com" \\\n  --tables users,orders --include-non-text --max-hits 20'
+                },
+                {
+                  kind: "command",
+                  title: "スナップショットを作成",
+                  command: 'code-viewer query snapshot create --db app.db --tables users,orders \\\n  --note "ユーザー登録テスト前"'
+                },
+                {
+                  kind: "command",
+                  title: "スナップショットの一覧 / メモ更新 / 削除",
+                  command: `code-viewer query snapshot list --db app.db --json
+code-viewer query snapshot note --id snap-abc123 --note "メモを更新"
+code-viewer query snapshot delete --id snap-abc123`
+                },
+                {
+                  kind: "command",
+                  title: "2 つのスナップショットを diff",
+                  command: `code-viewer query diff create --before snap-abc123 --after snap-def456 \\
+  --note "ユーザー登録テストの差分"
+code-viewer query diff list --db app.db --json
+code-viewer query diff delete --id diff-xyz789`
+                },
+                {
+                  kind: "command",
+                  title: "diff の中身を確認",
+                  command: `code-viewer query diff tables --id diff-xyz789
+code-viewer query diff rows --id diff-xyz789 --table users --type inserted --limit 50`
                 },
                 {
                   kind: "command",
@@ -19168,7 +19371,7 @@ code-viewer query clear --db app.db`
         skills: {
           nav: "スキル登録",
           title: "Agent Skill の登録",
-          intro: "このパッケージには、AI エージェントが code-viewer の annotate 機能を正しく使うためのスキルが同梱されています。",
+          intro: "このパッケージには 3 つのスキル (code-viewer-annotate / code-viewer-query / code-viewer-snapshot) が同梱されており、AI エージェントに annotate でのウォークスルー、read-only な query、スナップショット / 差分の使い分けを教えます。skill install を 1 回叩くと、選んだエージェントすべてに 3 スキルがコピーされます。",
           groups: [
             {
               title: "スキルをインストールする",
@@ -19193,6 +19396,12 @@ code-viewer query clear --db app.db`
                   kind: "command",
                   title: "ユーザー全体（プロジェクト外）へ登録",
                   command: "npx -y @youtyan/code-viewer skill install --agent all --global"
+                },
+                {
+                  kind: "command",
+                  title: "別プロジェクトのディレクトリへ登録",
+                  command: `npx -y @youtyan/code-viewer skill install --agent all --cwd /path/to/other/repo
+# --cwd でインストール先プロジェクトを指定。--global を併用したときは無視されます。`
                 }
               ]
             },
@@ -20313,7 +20522,7 @@ code-viewer query clear --db app.db`
         } else {
           lnHtml = '<td class="d2h-code-linenumber d2h-cntx">' + '<div class="line-num1">' + (oldStart + i2) + "</div>" + '<div class="line-num2">' + (newStart + i2) + "</div>" + "</td>";
         }
-        tr.innerHTML = lnHtml + '<td class="d2h-cntx">' + '<div class="' + (isSplit ? "d2h-code-side-line" : "d2h-code-line") + '">' + '<span class="d2h-code-line-prefix">&nbsp;</span>' + '<span class="d2h-code-line-ctn">' + escapeHtmlText(lines[i2]) + "</span>" + "</div>" + "</td>";
+        tr.innerHTML = lnHtml + '<td class="d2h-cntx">' + '<div class="' + (isSplit ? "d2h-code-side-line" : "d2h-code-line") + '">' + '<span class="d2h-code-line-prefix">&nbsp;</span> ' + '<span class="d2h-code-line-ctn">' + escapeHtmlText(lines[i2]) + "</span>" + "</div>" + "</td>";
         frag.appendChild(tr);
       }
       tbody.insertBefore(frag, anchor);
@@ -21359,7 +21568,7 @@ code-viewer query clear --db app.db`
       li.dataset.path = f2.path;
       li.dataset.type = "blob";
       li.classList.toggle("viewed", !onFileClick && STATE.viewedFiles.has(f2.path));
-      li.classList.toggle("hidden-by-tests", STATE.hideTests && isTestPath(f2.path || ""));
+      li.classList.toggle("hidden-by-tests", STATE.hideTests && !isRepositorySidebarMode() && isTestPath(f2.path || ""));
       li.style.setProperty("--lvl-pad", `${12 + depth * 14}px`);
       const spacer = document.createElement("span");
       spacer.className = "chev-spacer";
@@ -21458,7 +21667,7 @@ code-viewer query clear --db app.db`
             }
             subtreeVisible = subtreeVisible || visible;
           } else {
-            const testHidden = STATE.hideTests && isTestPath(item.file.path || "");
+            const testHidden = STATE.hideTests && !isRepositorySidebarMode() && isTestPath(item.file.path || "");
             const visible = !testHidden && matches(item.file.path || "");
             if (visible) {
               rows.push({
@@ -25460,6 +25669,9 @@ code-viewer query clear --db app.db`
     let highlightLoadPromise = null;
     let SERVER_SCOPE_OMIT_DIRS_DEFAULT = [];
     let SERVER_SCOPE_EXCLUDE_NAMES_DEFAULT = [];
+    let SERVER_SCOPE_WATCH_LIMIT_DEFAULT = 1024;
+    let SERVER_SCOPE_WATCH_LIMIT_MIN = 16;
+    let SERVER_SCOPE_WATCH_LIMIT_MAX = 65536;
     const UNDO_STACK = [];
     let PENDING_G_SCOPE = null;
     let PENDING_G_UNTIL = 0;
@@ -25826,6 +26038,12 @@ code-viewer query clear --db app.db`
         }
         SERVER_SCOPE_OMIT_DIRS_DEFAULT = normalizeScopeOmitDirs(settings.scope.omit_dirs_effective);
         SERVER_SCOPE_EXCLUDE_NAMES_DEFAULT = normalizeScopeExcludeNames(settings.scope.exclude_names_effective);
+        if (typeof settings.scope.watch_limit_default === "number")
+          SERVER_SCOPE_WATCH_LIMIT_DEFAULT = settings.scope.watch_limit_default;
+        if (typeof settings.scope.watch_limit_min === "number")
+          SERVER_SCOPE_WATCH_LIMIT_MIN = settings.scope.watch_limit_min;
+        if (typeof settings.scope.watch_limit_max === "number")
+          SERVER_SCOPE_WATCH_LIMIT_MAX = settings.scope.watch_limit_max;
         return settings;
       } catch {
         return null;
@@ -26184,15 +26402,20 @@ code-viewer query clear --db app.db`
           displaySource: "Applies to all projects in this browser.",
           excludedDirectories: "Excluded directories",
           omitDirs: "Skip these directory names while browsing and searching",
+          omitDirsHelp: "Reads no contents inside these directories. Applies to the sidebar (Files), Ctrl+K (file search), Ctrl+G (grep), Datastores, and the file change watcher.",
           excludeNames: "Hide these file or directory names completely",
+          excludeNamesHelp: "Removes matching files or directories from the sidebar, search, and grep results entirely. Unlike Skip, the names themselves disappear from the UI.",
           reset: "Restore defaults",
           autosaveNote: "Changes save automatically.",
-          scopeSource: (project, source) => `Saved for project "${project}" in this browser. Source: ${source}. Used by tree, Ctrl+K, and Ctrl+G. Restore defaults removes the browser override.`,
+          scopeSource: (project, source) => `Saved for project "${project}" in this browser. Source: ${source}. Used by the sidebar, Ctrl+K, Ctrl+G, Datastores, and the file change watcher. Restore defaults removes the browser override.`,
           browserOverride: "Browser override",
           serverDefault: "Server default",
           uploadsTitle: "Uploads",
           uploadEnabledLabel: "Allow file uploads into worktree folders",
-          uploadEnabledHelp: "Disable to make the worktree read-only for everyone using this server."
+          uploadEnabledHelp: "Disable to make the worktree read-only for everyone using this server.",
+          watchTitle: "File change watcher",
+          watchLimit: "Maximum directories to watch",
+          watchLimitHelp: (defaultLimit) => `Higher values reduce missed updates in deep trees at the cost of file handles. Combine with the Skip list above to keep heavy folders (node_modules, .git, dist...) out of the watch budget. Default: ${defaultLimit}.`
         },
         annotations: {
           title: "Code annotations",
@@ -26280,15 +26503,20 @@ code-viewer query clear --db app.db`
           displaySource: "このブラウザのすべてのプロジェクトに適用されます。",
           excludedDirectories: "除外ディレクトリ",
           omitDirs: "閲覧と検索でスキップするディレクトリ名",
+          omitDirsHelp: "これらのディレクトリの中身は読み込みません。サイドバー（Files）・Ctrl+K（ファイル検索）・Ctrl+G（grep）・Datastores・File change watcher の5機能すべてに適用されます。",
           excludeNames: "完全に非表示にするファイル名またはディレクトリ名",
+          excludeNamesHelp: "リスト中の名前に一致するファイル/ディレクトリを、サイドバー・検索結果・grep 結果から完全に消します。Skip と違い、名前自体が UI に出なくなります。",
           reset: "デフォルトに戻す",
           autosaveNote: "変更は自動で保存されます。",
-          scopeSource: (project, source) => `このブラウザのプロジェクト "${project}" に保存されます。ソース: ${source}。ツリー、Ctrl+K、Ctrl+G で使われます。「デフォルトに戻す」でブラウザ側の上書きを削除します。`,
+          scopeSource: (project, source) => `このブラウザのプロジェクト "${project}" に保存されます。ソース: ${source}。サイドバー、Ctrl+K、Ctrl+G、Datastores、File change watcher で使われます。「デフォルトに戻す」でブラウザ側の上書きを削除します。`,
           browserOverride: "ブラウザ側の上書き",
           serverDefault: "サーバ既定値",
           uploadsTitle: "アップロード",
           uploadEnabledLabel: "ワークツリーへのファイルアップロードを許可する",
-          uploadEnabledHelp: "オフにすると、このサーバを使う全員に対してワークツリーは読み取り専用になります。"
+          uploadEnabledHelp: "オフにすると、このサーバを使う全員に対してワークツリーは読み取り専用になります。",
+          watchTitle: "ファイル変更の監視",
+          watchLimit: "監視するディレクトリ数の上限",
+          watchLimitHelp: (defaultLimit) => `値を大きくすると深いツリーの変更を取りこぼしにくくなりますが、ファイルハンドル数を消費します。上の Skip リストと併用すると、重いフォルダ（node_modules, .git, dist など）を監視枠から外せます。既定値: ${defaultLimit}。`
         },
         annotations: {
           title: "コード注釈",
@@ -26406,14 +26634,20 @@ code-viewer query clear --db app.db`
         settingsSections[1].textContent = text2.settings.uploadsTitle;
       if (settingsSections[2])
         settingsSections[2].textContent = text2.settings.excludedDirectories;
+      if (settingsSections[3])
+        settingsSections[3].textContent = text2.settings.watchTitle;
       setElementText("#upload-enabled-label", text2.settings.uploadEnabledLabel);
       setElementText("#upload-help", text2.settings.uploadEnabledHelp);
+      setElementText("#scope-omit-dirs-help", text2.settings.omitDirsHelp);
+      setElementText("#scope-exclude-names-help", text2.settings.excludeNamesHelp);
+      setElementText("#scope-watch-limit-help", text2.settings.watchLimitHelp(SERVER_SCOPE_WATCH_LIMIT_DEFAULT));
       const labelMap = {
         "viewer-language": text2.settings.language,
         "sidebar-font-size": text2.settings.fileListFontSize,
         "code-font-size": text2.settings.codeFontSize,
         "scope-omit-dirs": text2.settings.omitDirs,
-        "scope-exclude-names": text2.settings.excludeNames
+        "scope-exclude-names": text2.settings.excludeNames,
+        "scope-watch-limit": text2.settings.watchLimit
       };
       Object.entries(labelMap).forEach(([id, label]) => {
         const labelEl = document.querySelector(`label[for="${id}"]`);
@@ -26597,6 +26831,19 @@ code-viewer query clear --db app.db`
 `);
       excludeInput.value = effectiveScopeExcludeNames().join(`
 `);
+      const watchLimitInput = document.querySelector("#scope-watch-limit");
+      const watchLimitRange = document.querySelector("#scope-watch-limit-range");
+      const watchLimitValue = effectiveScopeWatchLimit();
+      if (watchLimitInput) {
+        watchLimitInput.min = String(SERVER_SCOPE_WATCH_LIMIT_MIN);
+        watchLimitInput.max = String(SERVER_SCOPE_WATCH_LIMIT_MAX);
+        watchLimitInput.value = String(watchLimitValue);
+      }
+      if (watchLimitRange) {
+        watchLimitRange.min = String(SERVER_SCOPE_WATCH_LIMIT_MIN);
+        watchLimitRange.max = String(SERVER_SCOPE_WATCH_LIMIT_MAX);
+        watchLimitRange.value = String(watchLimitValue);
+      }
       const uploadToggle = document.querySelector("#upload-enabled");
       if (uploadToggle)
         uploadToggle.checked = APP_SETTINGS.uploadEnabled !== false;
@@ -26653,6 +26900,41 @@ code-viewer query clear --db app.db`
       refreshScopeSourceLabel();
       refreshRepositoryTreeAfterSettings();
     }
+    function normalizeScopeWatchLimit(value) {
+      const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : Number.NaN;
+      if (!Number.isFinite(parsed))
+        return null;
+      const floored = Math.floor(parsed);
+      if (floored < SERVER_SCOPE_WATCH_LIMIT_MIN)
+        return SERVER_SCOPE_WATCH_LIMIT_MIN;
+      if (floored > SERVER_SCOPE_WATCH_LIMIT_MAX)
+        return SERVER_SCOPE_WATCH_LIMIT_MAX;
+      return floored;
+    }
+    function effectiveScopeWatchLimit() {
+      const saved = normalizeScopeWatchLimit(APP_SETTINGS.scopeWatchLimit);
+      return saved ?? SERVER_SCOPE_WATCH_LIMIT_DEFAULT;
+    }
+    function syncScopeWatchLimitInputs(value) {
+      const numberInput = document.querySelector("#scope-watch-limit");
+      const rangeInput = document.querySelector("#scope-watch-limit-range");
+      if (numberInput && numberInput.value !== String(value))
+        numberInput.value = String(value);
+      if (rangeInput && rangeInput.value !== String(value))
+        rangeInput.value = String(value);
+    }
+    function saveScopeWatchLimitField(value) {
+      const next = normalizeScopeWatchLimit(value);
+      const resolved = next ?? SERVER_SCOPE_WATCH_LIMIT_DEFAULT;
+      mergeLocalSettings({ scopeWatchLimit: resolved });
+      patchSettings({ scopeWatchLimit: resolved });
+      syncScopeWatchLimitInputs(resolved);
+    }
+    function previewScopeWatchLimit(value) {
+      const next = normalizeScopeWatchLimit(value);
+      if (next != null)
+        syncScopeWatchLimitInputs(next);
+    }
     function resetScopeSettings() {
       setViewerLanguage("en", false);
       mergeLocalSettings({
@@ -26660,6 +26942,7 @@ code-viewer query clear --db app.db`
         codeFontSize: null,
         scopeOmitDirs: null,
         scopeExcludeNames: null,
+        scopeWatchLimit: null,
         uploadEnabled: null
       });
       applySidebarFontSize("regular");
@@ -26670,6 +26953,7 @@ code-viewer query clear --db app.db`
         codeFontSize: null,
         scopeOmitDirs: null,
         scopeExcludeNames: null,
+        scopeWatchLimit: null,
         uploadEnabled: null
       });
       const sidebarFontSize = document.querySelector("#sidebar-font-size");
@@ -26848,6 +27132,7 @@ code-viewer query clear --db app.db`
       if (STATE.route.screen !== "database") {
         setQueryHistoryPanelOpen(false);
       }
+      applyHideTests();
     }
     function syncHeaderMenu() {
       document.querySelectorAll(".app-menu-item, .global-help-link").forEach((link2) => {
@@ -27087,6 +27372,15 @@ code-viewer query clear --db app.db`
     $("#scope-exclude-names")?.addEventListener("change", (event) => {
       saveScopeExcludeNamesField(event.currentTarget.value);
     });
+    $("#scope-watch-limit")?.addEventListener("change", (event) => {
+      saveScopeWatchLimitField(event.currentTarget.value);
+    });
+    $("#scope-watch-limit-range")?.addEventListener("input", (event) => {
+      previewScopeWatchLimit(event.currentTarget.value);
+    });
+    $("#scope-watch-limit-range")?.addEventListener("change", (event) => {
+      saveScopeWatchLimitField(event.currentTarget.value);
+    });
     $("#scope-settings-popover")?.addEventListener("keydown", (e2) => {
       if (isImeComposing(e2))
         return;
@@ -27740,13 +28034,14 @@ code-viewer query clear --db app.db`
       const btn = $("#hide-tests");
       if (btn)
         btn.classList.toggle("active", STATE.hideTests);
+      const effective = STATE.hideTests && !isRepositorySidebarMode();
       document.querySelectorAll(".gdp-file-shell").forEach((card) => {
         const isTest = TEST_RE.test(card.dataset.path || "");
-        card.classList.toggle("hidden-by-tests", STATE.hideTests && isTest);
+        card.classList.toggle("hidden-by-tests", effective && isTest);
       });
       document.querySelectorAll("#filelist li[data-path]").forEach((li) => {
         const isTest = TEST_RE.test(li.dataset.path || "");
-        li.classList.toggle("hidden-by-tests", STATE.hideTests && isTest);
+        li.classList.toggle("hidden-by-tests", effective && isTest);
       });
       if (isVirtualSidebarActive())
         rerenderVirtualSidebar();

package/web/index.html

@@ -177,10 +177,21 @@
       <strong class="scope-settings-section-title">Excluded directories</strong>
       <label for="scope-omit-dirs">Skip these directory names while browsing and searching</label>
       <textarea id="scope-omit-dirs" rows="6" spellcheck="false"></textarea>
+      <p id="scope-omit-dirs-help" class="scope-settings-help"></p>
       <label for="scope-exclude-names">Hide these file or directory names completely</label>
       <textarea id="scope-exclude-names" rows="4" spellcheck="false"></textarea>
+      <p id="scope-exclude-names-help" class="scope-settings-help"></p>
       <p id="scope-omit-source"></p>
     </div>
+    <div class="scope-settings-section">
+      <strong id="watch-section-title" class="scope-settings-section-title">File change watcher</strong>
+      <label for="scope-watch-limit">Maximum directories to watch</label>
+      <div class="scope-watch-limit-row">
+        <input id="scope-watch-limit-range" type="range" min="16" max="65536" step="16" aria-label="watch limit slider" />
+        <input id="scope-watch-limit" type="number" min="16" max="65536" step="1" />
+      </div>
+      <p id="scope-watch-limit-help" class="scope-settings-help"></p>
+    </div>
     <div class="scope-settings-footer">
       <p id="scope-settings-autosave-note" class="scope-settings-help"></p>
       <button id="scope-omit-reset" type="button">Restore defaults</button>

package/web/style.css

@@ -1735,6 +1735,20 @@ body.gdp-history-resizing * {
   gap: 8px;
   margin-top: 10px;
 }
+.scope-watch-limit-row {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+}
+.scope-watch-limit-row input[type="range"] {
+  flex: 1;
+  min-width: 0;
+  accent-color: var(--accent, #2b6cb0);
+}
+.scope-watch-limit-row input[type="number"] {
+  width: 88px;
+  flex: 0 0 auto;
+}
 .scope-settings-toggle {
   display: flex;
   align-items: center;