mirror of
https://github.com/ultraworkers/claw-code.git
synced 2026-04-24 13:08:11 +08:00
roadmap: #136 + #153b marked CLOSED — compact+json already correct, PATH docs comprehensive
This commit is contained in:
parent
196fe6b493
commit
7bd91096a8
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
|
||||
|
||||
**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:
|
||||
1. Where binary ends up (`rust/target/debug/claw` vs. `/usr/local/bin/claw`)
|
||||
2. How to verify build (e.g., `./rust/target/debug/claw --help`)
|
||||
3. How to add to PATH for shell integration
|
||||
**Implementation in README.md (lines 139–175):** Comprehensive PATH setup section with three options:
|
||||
1. **Symlink (macOS/Linux):** `ln -s $(pwd)/rust/target/debug/claw /usr/local/bin/claw`
|
||||
2. **cargo install:** Build and install to `~/.cargo/bin/`
|
||||
3. **Shell profile:** Add `export PATH="$(pwd)/rust/target/debug:$PATH"` to `.bashrc`/`.zshrc`
|
||||
|
||||
**Real user friction (from #claw-code):**
|
||||
- "claw not found — did build fail?"
|
||||
- "do I need `cargo install`?"
|
||||
- "why is it at `rust/target/debug/claw` and not just `claw`?"
|
||||
Includes:
|
||||
- Binary location callout (`rust/target/debug/claw` on all platforms)
|
||||
- Verification step (`claw --help`)
|
||||
- Troubleshooting for "command not found" error
|
||||
|
||||
**Fix shape (minimal, ~40 lines):**
|
||||
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"
|
||||
**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`
|
||||
claw --help # should work from anywhere
|
||||
```
|
||||
4. **Permanent setup:** Add the export to `.bashrc` / `.zshrc` if desired
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user