Delimit//Shared local state for AI coding agents

Keep the state.
Change the model.

Save decisions and task handoffs in local files. A connected assistant can look them up in a later session, even after you switch tools. API checks and optional model review are separate paths when you need them.

$ npx delimit-cli setup

Free core. No account or model API key needed for local memory. Setup needs Node.js, Python 3.9+ and a supported assistant; it may check for updates and download modules.

Start locally

Read the transcript

Terminal · delimit-cli 4.20.1

$ npx delimit-cli remember "Rejected Redis for sessions: no persistence guarantee on our plan"
  Remembered. (1 memory total)

$ npx delimit-cli recall redis
  Delimit Memories
    [mem-376224674f99] just now [cli] ✓
    Rejected Redis for sessions: no persistence guarantee on our plan
    #redis
  1 memory found (1 total)

Output from delimit-cli 4.20.1 in a clean scratch home, no account or model key. The next assistant must be asked to look up the decision.

01Continuity

Tell it once. Every assistant can find it.

Save a decision from the terminal or from inside an assistant. It is stored in ~/.delimit on your machine, and the next session can look it up, in the same assistant or a different one.

01Run setup, connect a supported assistant, restart it.
02Save a decision; ask the next session to retrieve it.
03Free: assistants read recent entries and the CLI searches by term. Pro adds search by meaning.

02Routing

Hand unfinished work to the next runtime.

Tasks and handoff notes live in a local ledger, so moving from Claude Code to Codex when a quota runs out does not mean starting over. Each assistant still has to read the record; nothing moves on its own.

01 · Lane A
claude-code
Works the task and writes a handoff: what is done, what is left, what was decided.
02 · Ledger
~/.delimit
The task, its notes and the decisions are saved as local records.
03 · Lane B
codex
Reads the same record and picks up where the last session stopped.

Handoff method

03Governance

Check the change before it lands.

Catch breaking OpenAPI changes on your machine or in the GitHub Action. The Action comments by default. Set mode: enforce or fail_on_breaking: true to fail its job, then require that check in branch protection to block a merge.

$ npx delimit-cli try

Runs the check on a built-in sample API and saves a short report. No account needed.

Start the API release safety path

Receipts

Keep a record of what ran

Wrap a command to save a locally HMAC-signed receipt of the evidence it captures. It does not establish correctness, security or human approval.

What receipts prove See a signed release receipt (v4.7.2)

04Local records

Useful alongside your project files.

ADRs, AGENTS.md, CLAUDE.md and manual handoffs can carry the same information. Delimit adds local, dated memory, task and handoff records that a connected assistant can query when you ask. It does not replace source files, git history, or your review.

Records live under ~/.delimit. Setup connects Claude Code, Codex and Cursor when detected; Antigravity uses its own config. delimit chat wraps Copilot or Muse. Depth differs by assistant. Model requests go to providers you configure, and setup may make update and module download requests.

Data handling FAQ

05What works today

Shipped, and where it is going.

In the free package today

Shared memory: decisions and notes any connected assistant can look up
A local ledger of tasks and handoff notes
API breaking-change check before merge, in the CLI and the GitHub Action
Local receipts of what a wrapped command ran, signed with a key on your machine

Direction, not shipped

Coordinating several agents on one task under rules you set
Hosted replay of receipts (not available yet)

Roadmap

> Initialize locally

Start with one command.

$ npx delimit-cli setup

The core tools are free. Pro is $10 a month; see the pricing page for its boundaries.

Start locally Compare plans

Already have an account? Sign in

Keep the state.Change the model.