agentedlisted

# agented (binary: `ae`) `ae` is a stateful editor controlled by command-line verbs. State persists across sessions in a SQLite-backed workspace (`.agented/state.db`). Every edit is versioned in an undo tree — you can branch, jump to any past state, and never lose work. **`ae` not on PATH?** `npx -y agented <verb> ...` runs the identical binary — the npm launcher downloads the platform build from GitHub releases on first use (sha256-verified) and caches it, so later calls are instant and offline. Every command in this document works verbatim with `npx -y agented` in place of `ae`. Prefer a real install for daily use (`brew install frane/tap/agented` or `npm i -g agented`). ## Use this tool when - You need to edit one or more files in a repo across multiple steps and want a durable history. - You want to leave notes for your future self or other agents (annotations) attached to specific files. - You want safe multi-file refactors with all-or-nothing semantics (transactions). ## Don't use this tool for - Reading repo overview / architecture (use plain `cat`/grep). - Single one-shot edits where you don't care about history (use the platform's built-in editor). - Anything that isn't text (no binary file support). ## How the editor enforces correctness for you Every read returns a `state_token`. Pass it to your next write with `--expect`. If the file changed under you, the write is rejected (exit code 3) and the response includes the new content and the new token. Retry wi