From b1d76983d26902c5a17d9ba3d8cc8b636c290fa8 Mon Sep 17 00:00:00 2001
From: YeonGyu-Kim <code.yeon.gyu@gmail.com>
Date: Thu, 9 Apr 2026 10:35:50 +0900
Subject: [PATCH] docs(readme): warn that cargo install clawcode is not
 supported; show build-from-source path

Repeated onboarding friction in #claw-code: users try 'cargo install clawcode'
which fails because the package is not published on crates.io. Add a prominent
NOTE callout before the quick-start block directing users to build from source.

Source: gaebal-gajae pinpoint 2026-04-09 from #claw-code.
---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index adbbe11..cb8cc60 100644
--- a/README.md
+++ b/README.md
@@ -45,8 +45,12 @@ The canonical implementation lives in [`rust/`](./rust), and the current source
 
 ## Quick start
 
+> [!NOTE]
+> **`cargo install clawcode` will not work** — this package is not published on crates.io. Build from source as shown below.
+
 ```bash
-cd rust
+git clone https://github.com/ultraworkers/claw-code
+cd claw-code/rust
 cargo build --workspace
 ./target/debug/claw --help
 ./target/debug/claw prompt "summarize this repository"