歡迎使用 Heddle
Heddle 是開源、本機優先的程式開發代理框架、執行環境與 terminal-first workspace，專為可追蹤的程式碼庫工作而設計。
它適合 agent 需要檢查真實程式碼庫、進行有邊界的修改、驗證結果、跨 session 保持連續性，並讓 operator 能持續看見工作狀態的流程。Heddle 支援 OpenAI 與 Anthropic model，把工作區本地狀態存放在 .heddle/，並提供可審查的 diff、command、approval 與 trace 路徑。
在 Heddle v3 版本線中，heddle 與 heddle chat 會開啟支援 API-backed 的 terminal UI。終端機、瀏覽器與行動端 client 共享同一條本機 control-plane 路徑，用於 session、approval、即時狀態、工作區 review、memory 與 heartbeat task。
核心概念
Workspace
Heddle 正在操作的本機專案。預設會使用目前目錄；也可以透過 --cwd 指定其他路徑。
.heddle/
工作區本地狀態目錄，用來存放 saved sessions、traces、approvals、memory notes、uploads、heartbeat tasks 與 run records。
Session
保存下來的多輪對話，包含 model 設定、reasoning effort、compacted history、queued prompt 與 trace link。
Trace
可審查的事件紀錄，包含 tool call、command evidence、approval、file diff 與 agent turn 的 runtime event。
Approval
operator 對敏感動作的確認，例如檔案修改或 shell command。Heddle 會讓 approval 狀態保持可見，而不是把自動化藏起來。
Memory
以 catalog 管理的 markdown note，用來保存可重用的專案知識、偏好、工作流程、操作慣例與 current state。
Control plane
本機瀏覽器 UI 與 API server，讓終端機、瀏覽器、行動端 client 共享 session、review、task 與 workspace state。
Heartbeat task
可排程或重複執行的 durable agent task，具備 bounded run、checkpoint、run history 與 continuation decision。
Heddle 適合誰
Heddle 適合想要 AI 程式開發助理能在真實程式碼庫裡工作、保留本機狀態、學習可重用專案知識，並留下 review trail 的開發者。它適合程式碼庫導覽、實作任務、文件修改、測試與 build 驗證、跨裝置監督，以及週期性維護流程。
Heddle 不只是 stateless prompt wrapper。它的產品形態是本機優先的程式開發代理框架與執行環境：tool、approval、trace、session、memory 與瀏覽器監督都保持明確，讓 operator 能理解改了什麼以及為什麼。