Traceable agent work
for real repositories.
Heddle is an open-source coding agent harness, runtime, and CLI. Give agents local workspace access, saved sessions, approvals, traces, memory, heartbeat tasks, local or hosted model access, and a browser control plane — without turning repository work into black-box automation.
Video introduction
See Heddle in motion
Watch a short walkthrough of Heddle as a local-first coding agent harness and runtime for terminal work, reviewable changes, persistent sessions, and operator oversight.
Every feature you need.
A traceable coding agent harness — built for real repository work, not just one-shot prompts.
Terminal-First Chat
Run heddle in any repository with hosted models or local Ollama models. Inspect files, explain code, make edits, run shell commands, and carry multi-step tasks through multiple turns — without leaving your shell.
Explicit Review
Every change is a reviewable diff. Structured approvals, turn-level traces, and verification commands — so you always know exactly what the agent did.
Knowledge Persistence
Heddle learns durable knowledge while it works. Preferences, ticket formats, canonical commands — cataloged under .heddle/memory/ and recovered in future sessions.
Browser Control Plane
Run heddle daemon for a local browser UI. Switch between workspaces, review sessions, inspect diffs, manage heartbeat tasks, and monitor memory health — from any device.
Traceable agent work
starts here.
If you want a coding agent harness with local state, review traces, workspace memory, and a path toward longer-running workflows — that is the problem Heddle is built to solve.