Home
Docs
Heddle 1.0 is here

Agent runtime forreal project work.

An open-source terminal coding agent runtime for real project work. Inspect live repositories, make bounded changes, keep continuity across sessions, and stay observable — not just a one-shot prompt wrapper.

user — -zsh — 120x30
Last login: Mon May 4 09:03:12 on ttys001
user@mac:~/projects/my-app$heddle daemon
✓ Daemon started. Control plane at http://localhost:3000
Workspace: ~/projects/my-app (.heddle/)
user@mac:~/projects/my-app$heddle
› Summarize this repo and show the main entrypoints.
Reading package.json... Reading src/index.ts... Done.
heddle

Every feature you need.

A complete agentic runtime — built for real project work, not just one-shot prompts.

U
Find the bug in auth.ts and fix it.
H
Reading workspace files...

Terminal-First Chat

Run heddle in any repository. Inspect files, explain code, make edits, run shell commands, and carry multi-step tasks through multiple turns — without leaving your shell.

page.tsx
12<Button onClick={submit}>
13- <span>Submit</span>
13+ <Loader className="animate-spin" />
14</Button>
Approved

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.

.heddle/memory

Knowledge Persistence

Heddle learns durable knowledge while it works. Preferences, ticket formats, canonical commands — cataloged under .heddle/memory/ and recovered in future sessions.

heddle daemon
workspace A
workspace B
session
memory
workspace C

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.

The agent that keeps up
with real work.

If you want a coding agent with local state, review traces, workspace memory, and a path toward longer-running workflows — that is the problem Heddle is built to solve.