@youtyan/code-viewer 0.6.2 → 0.6.4

package/README.md

@@ -100,6 +100,10 @@ Common options:
 - `--cwd <dir>` — repository to view (default: current working directory).
 - `--open` — open the printed URL in the default browser.
 - `--port <port>` — bind to a specific port (default: pick a free port).
+- `--bin <name>=<absolute-path>` — override an external command path
+  (`git`, `rg`, `docker`, or `gh`). The same values can be supplied through
+  `CODE_VIEWER_BIN_GIT`, `CODE_VIEWER_BIN_RG`, `CODE_VIEWER_BIN_DOCKER`, and
+  `CODE_VIEWER_BIN_GH`.
 - `--scope-omit-dir <name>` — skip a directory under the worktree (repeatable;
   overrides the Viewer Settings list for this session).
 - `--version`, `-v` — print the installed version.
@@ -115,6 +119,10 @@ code-viewer HEAD~1 HEAD
 code-viewer --cwd /path/to/repo --staged
 ```
 
+`--bin` is useful when several command installations exist or a login shell
+PATH differs from the environment that starts code-viewer. Override paths must
+be absolute executable files outside the opened repository.
+
 Open **Viewer Settings** in the header to change display options such as
 theme, layout, sidebar mode, font sizes, and UI language. The language setting
 translates the viewer chrome itself, including the Help page, settings labels,
@@ -505,8 +513,8 @@ stdout and adds `text truncated` to stderr when the server flagged
 truncation. `--json` always emits the full server response envelope.
 
 AI agents who don't yet know which subcommand they need can run
-`code-viewer agent-help` once. It prints a short index of the seven
-AI-facing entry points (`status`, `query`, `annotate`, `search`,
+`code-viewer agent-help` once. It prints a short index of the eight
+AI-facing entry points (`status`, `query`, `annotate`, `journal`, `search`,
 `file`, `skill`, `doctor`) with the exact `code-viewer <name>
 agent-help` command for each full guide. The index runs without any
 preflight, so it works even before SQLite or a running server is set
@@ -531,6 +539,9 @@ code-viewer status --json
 
 # Override the ref / depth used for "recent commits".
 code-viewer status --ref main --limit 20 --json
+
+# Use a specific git binary when PATH resolution is not the one you want.
+code-viewer status --bin git=/opt/bin/git --json
 ```
 
 The `nextCommands` field pins `--server '<url>'` automatically for
@@ -587,6 +598,9 @@ code-viewer search files --term "src/**/*.test.ts" --max 200 --json
 
 # Look at a specific ref instead of the worktree.
 code-viewer search files --term "config" --ref main --json
+
+# Pin the git binary used for CLI-side repository discovery.
+code-viewer search files --term "config" --bin git=/opt/bin/git --json
 ```
 
 Default text output is one path per line, best first. An empty result
@@ -630,6 +644,9 @@ code-viewer file show --path src/sample.ts --ref main --json
 code-viewer file diff --path src/sample.ts --json
 code-viewer file diff --path src/sample.ts --from HEAD~1 --to HEAD --full --json
 code-viewer file diff --path new_sample.ts --untracked --json
+
+# Pin the git binary used by local file/blame/history/diff reads.
+code-viewer file history --path src/sample.ts --bin git=/opt/bin/git --json
 ```
 
 Default (non-`--json`) output is tab-separated and easy to grep:
@@ -650,8 +667,8 @@ including the JSON contract for each subcommand.
 
 The same diagnostic report behind the Environment Doctor sheet (see
 Features above) is available from the terminal without a browser, so AI
-agents and CI can introspect the runtime, SQLite driver, Git, Docker
-discovery, and snapshot store status directly.
+agents and CI can introspect the runtime, SQLite driver, Git, GitHub CLI,
+Docker discovery, and snapshot store status directly.
 
 ```sh
 # Human-readable status summary.
@@ -660,6 +677,7 @@ code-viewer doctor
 # Full DoctorReport JSON (matches the /_doctor endpoint).
 code-viewer doctor --json
 code-viewer doctor --cwd /path/to/repo --port 64160 --json
+code-viewer doctor --bin git=/opt/bin/git --bin docker=/opt/bin/docker --bin gh=/opt/bin/gh --json
 ```
 
 The exit code is `1` iff the worst check status is `"error"` (never on
@@ -750,11 +768,12 @@ write concise Markdown explanations, and how to install the bundled agent skill.
 
 ### Agent Skill
 
-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:
+The package bundles four [Agent Skills](https://agentskills.io)
+(the SKILL.md open standard) — `code-viewer-annotate`,
+`code-viewer-journal`, `code-viewer-query`, and `code-viewer-snapshot` —
+that teach AI coding agents when and how to use `annotate`, Work Log task
+queues, read-only `query`, and snapshot / diff workflows. A single
+`skill install` copies all four into the selected agent directories:
 
 ```sh
 npx -y @youtyan/code-viewer skill install                       # Claude Code (.claude/skills/)