mirror of
https://github.com/ultraworkers/claw-code.git
synced 2026-04-24 21:28:11 +08:00
merge: docs/jobdori-162-usage-verb-parity — document dump-manifests/bootstrap-plan/acp/export
Completes discoverability chain for 4 verbs: - dump-manifests — upstream manifest export - bootstrap-plan — startup component graph - acp — Zed editor integration status (tracking #76) - export — session transcript export Per MERGE_CHECKLIST.md Cluster 6 (P3 Doc-truthfulness): - Diff: +87 lines in USAGE.md (doc-only) - Zero code risk - Parity audit: 12/12 verbs documented (was 8/12) Applied: execution artifact runbook. Cycle #72 integration.
This commit is contained in:
commit
378b9bf533
87
USAGE.md
87
USAGE.md
@ -422,6 +422,93 @@ cd rust
|
|||||||
./target/debug/claw system-prompt --cwd .. --date 2026-04-04
|
./target/debug/claw system-prompt --cwd .. --date 2026-04-04
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### `dump-manifests` — Export upstream plugin/MCP manifests
|
||||||
|
|
||||||
|
**Purpose:** Dump built-in tool and plugin manifests to stdout as JSON, for parity comparison against the upstream Claude Code TypeScript implementation.
|
||||||
|
|
||||||
|
**Prerequisite:** This command requires access to upstream source files (`src/commands.ts`, `src/tools.ts`, `src/entrypoints/cli.tsx`). Set `CLAUDE_CODE_UPSTREAM` env var or pass `--manifests-dir`.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Via env var
|
||||||
|
CLAUDE_CODE_UPSTREAM=/path/to/upstream claw dump-manifests
|
||||||
|
|
||||||
|
# Via flag
|
||||||
|
claw dump-manifests --manifests-dir /path/to/upstream
|
||||||
|
```
|
||||||
|
|
||||||
|
**When to use:** Parity work (comparing the Rust port's tool/plugin surface against the canonical TypeScript implementation). Not needed for normal operation.
|
||||||
|
|
||||||
|
**Error mode:** If upstream sources are missing, exits with `error-kind: missing_manifests` and a hint about how to provide them.
|
||||||
|
|
||||||
|
### `bootstrap-plan` — Show startup component graph
|
||||||
|
|
||||||
|
**Purpose:** Print the ordered list of startup components that are initialized when `claw` begins a session. Useful for debugging startup issues or verifying that fast-path optimizations are in place.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
claw bootstrap-plan
|
||||||
|
```
|
||||||
|
|
||||||
|
**Sample output:**
|
||||||
|
```
|
||||||
|
- CliEntry
|
||||||
|
- FastPathVersion
|
||||||
|
- StartupProfiler
|
||||||
|
- SystemPromptFastPath
|
||||||
|
- ChromeMcpFastPath
|
||||||
|
```
|
||||||
|
|
||||||
|
**When to use:**
|
||||||
|
- Debugging why startup is slow (compare your plan to the expected one)
|
||||||
|
- Verifying that fast-path components are registered
|
||||||
|
- Understanding the load order before customizing hooks or plugins
|
||||||
|
|
||||||
|
**Related:** See `claw doctor` for health checks against these startup components.
|
||||||
|
|
||||||
|
### `acp` — Agent Context Protocol / Zed editor integration status
|
||||||
|
|
||||||
|
**Purpose:** Report the current state of the ACP (Agent Context Protocol) / Zed editor integration. Currently **discoverability only** — no editor daemon is available yet.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
claw acp
|
||||||
|
claw acp serve # same output; `serve` is accepted but not yet launchable
|
||||||
|
claw --acp # alias
|
||||||
|
claw -acp # alias
|
||||||
|
```
|
||||||
|
|
||||||
|
**Sample output:**
|
||||||
|
```
|
||||||
|
ACP / Zed
|
||||||
|
Status discoverability only
|
||||||
|
Launch `claw acp serve` / `claw --acp` / `claw -acp` report status only; no editor daemon is available yet
|
||||||
|
Today use `claw prompt`, the REPL, or `claw doctor` for local verification
|
||||||
|
Tracking ROADMAP #76
|
||||||
|
```
|
||||||
|
|
||||||
|
**When to use:** Check whether ACP/Zed integration is ready in your current build. Plan around its availability (track ROADMAP #76 for status).
|
||||||
|
|
||||||
|
**Today's alternatives:** Use `claw prompt` for one-shot runs, the interactive REPL for iterative work, or `claw doctor` for local verification.
|
||||||
|
|
||||||
|
### `export` — Export session transcript
|
||||||
|
|
||||||
|
**Purpose:** Export a managed session's transcript to a file or stdout. Operates on the currently-resumed session (requires `--resume`).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Export latest session
|
||||||
|
claw --resume latest export
|
||||||
|
|
||||||
|
# Export specific session
|
||||||
|
claw --resume <session-id> export
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prerequisite:** A managed session must exist under `.claw/sessions/<workspace-fingerprint>/`. If no sessions exist, the command exits with `error-kind: no_managed_sessions` and a hint to start a session first.
|
||||||
|
|
||||||
|
**When to use:**
|
||||||
|
- Archive session transcripts for review
|
||||||
|
- Share session context with teammates
|
||||||
|
- Feed session history into downstream tooling
|
||||||
|
|
||||||
|
**Related:** Inside the REPL, `/export` is also available as a slash command for the active session.
|
||||||
|
|
||||||
## Session management
|
## Session management
|
||||||
|
|
||||||
REPL turns are persisted under `.claw/sessions/` in the current workspace.
|
REPL turns are persisted under `.claw/sessions/` in the current workspace.
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user