開始使用 / 快速開始
快速開始
啟動第一個 Heddle session、檢查真實程式碼庫，並開啟瀏覽器 review surface。
1. 安裝 CLI
Terminal
npm install -g @roackb2/heddle2. 設定 provider 存取
你可以用 OpenAI account sign-in 快速完成本機設定，也可以從 shell 提供 OpenAI 或 Anthropic API key。
Terminal
heddle auth login openai
# 或
export OPENAI_API_KEY="your_key"
export ANTHROPIC_API_KEY="your_key"3. 啟動 session
兩分鐘試用路徑
cd /path/to/your/project
heddle
# → "Summarize this repo and show the main entrypoints."
# 一次性替代方式：
heddle ask "List the main build and test commands"4. 開啟瀏覽器 control plane
daemon 會提供 Heddle 的本機瀏覽器 control plane。你可以用它檢查 saved session、審查目前 Git diff、觀看 live run status、檢查 memory health，並管理 heartbeat task。
Terminal
heddle daemon
# 從 daemon output 開啟 http://127.0.0.1:8765實用的第一批 prompts
Summarize this repository, identify the main entrypoints, and list build/test commands.
Find the highest-risk TODOs or failing tests and propose a safe first fix.
Review the current git diff and tell me what should be verified before commit.
你應該會看到什麼
- terminal UI 會串流 assistant 文字、tool activity、plan 與 approval wait。
- run 會以 session 形式儲存在 .heddle/ 下，方便之後延續與審查。
- Browser Sessions 可以顯示同一段對話與目前工作區 diff。
- 當 Heddle 發現持久專案事實或偏好時，可能會記錄 memory candidate。