mirror of
https://github.com/instructkr/claw-code.git
synced 2026-04-26 23:04:58 +08:00
roadmap: #136 + #153b marked CLOSED — compact+json already correct, PATH docs comprehensive
This commit is contained in:
26
ROADMAP.md
26
ROADMAP.md
@@ -7031,25 +7031,19 @@ Filesystem operation errors must emit operation name + path in error message, en
|
|||||||
|
|
||||||
## Pinpoint #153b (follow-up). Add binary PATH setup guide to README
|
## Pinpoint #153b (follow-up). Add binary PATH setup guide to README
|
||||||
|
|
||||||
**Concrete gap (from cycle #48 assessment):**
|
**Status: ✅ CLOSED (already implemented, verified cycle #60).**
|
||||||
|
|
||||||
#153 filed in cycle #30 but never landed. New users post-`cargo build --workspace` don't know:
|
**Implementation in README.md (lines 139–175):** Comprehensive PATH setup section with three options:
|
||||||
1. Where binary ends up (`rust/target/debug/claw` vs. `/usr/local/bin/claw`)
|
1. **Symlink (macOS/Linux):** `ln -s $(pwd)/rust/target/debug/claw /usr/local/bin/claw`
|
||||||
2. How to verify build (e.g., `./rust/target/debug/claw --help`)
|
2. **cargo install:** Build and install to `~/.cargo/bin/`
|
||||||
3. How to add to PATH for shell integration
|
3. **Shell profile:** Add `export PATH="$(pwd)/rust/target/debug:$PATH"` to `.bashrc`/`.zshrc`
|
||||||
|
|
||||||
**Real user friction (from #claw-code):**
|
Includes:
|
||||||
- "claw not found — did build fail?"
|
- Binary location callout (`rust/target/debug/claw` on all platforms)
|
||||||
- "do I need `cargo install`?"
|
- Verification step (`claw --help`)
|
||||||
- "why is it at `rust/target/debug/claw` and not just `claw`?"
|
- Troubleshooting for "command not found" error
|
||||||
|
|
||||||
**Fix shape (minimal, ~40 lines):**
|
**Dogfood verification (2026-04-23 cycle #60):** Docs are clear, comprehensive, and cover the three main user scenarios. No new friction surfaces when following README after `cargo build --workspace`
|
||||||
Add "Post-build: Add to PATH" section in README (after Quick start), covering:
|
|
||||||
1. **Binary location:** `rust/target/debug/claw` (debug) or `rust/target/release/claw` (release)
|
|
||||||
2. **Quick verification:** `./rust/target/debug/claw --help` (no install needed)
|
|
||||||
3. **Optional PATH setup:**
|
|
||||||
```bash
|
|
||||||
export PATH="$PWD/rust/target/debug:$PATH"
|
|
||||||
claw --help # should work from anywhere
|
claw --help # should work from anywhere
|
||||||
```
|
```
|
||||||
4. **Permanent setup:** Add the export to `.bashrc` / `.zshrc` if desired
|
4. **Permanent setup:** Add the export to `.bashrc` / `.zshrc` if desired
|
||||||
|
|||||||
Reference in New Issue
Block a user