Your agent stops when it thinks it's done. This one stops when it's actually done.
An autonomous agent environment for Claude Code, modeled on human memory.
Hand it months of work and rest: it finishes in days.
▶ Watch the memory circuit run
English | 한국어
Claude Code ends its turn the moment it believes it's finished, and loses the detail at the next compaction. claude-automata rebuilds it around the way human memory works:
| Plugin | Memory role |
|---|---|
| ploop | working memory: a single session sails autonomously for days; an independent advisor audits every stop |
| tx | consolidation: the screening gate into long-term memory (independent verify, CI, squash merge) |
| refine | re-grounding: large-scale workflows that eliminate technical debt |
Long-term memory is the repository's own git-tracked text, not a database. Recall is grep. Whatever never passes the gate dies with the loop, on purpose.
Install
Needs Claude Code and uv on POSIX (macOS / Linux / WSL). One command, inside a git repository:
uvx claude-automata init
Re-running is safe (idempotent). uvx claude-automata@latest init forces the newest release.
What init writes. It sets up the environment claude-automata needs to run reliably:
permissions.defaultMode: "bypassPermissions"model: "opus[1m]"alwaysThinkingEnabled: true·autoCompactEnabled: true·autoMemoryEnabled: false- registers the
clomia/claude-automatamarketplace and enables its plugins - installs
repomixandgh
Run a loop
/ploop:define-mission # an agent interviews you and writes the anchor
/ploop:launch [anchor text] # hand it to the loop in a fresh session
Declare it done and a hook blocks the stop, summoning an independent advisor: the loop's metacognition, with access to the whole story. The loop ends when the advisor has nothing left to say.
agent › Mission accomplished. Stopping.
hook › Stop blocked. Summoning the advisor.
advisor › Not yet. The mobile layout was never measured. Two claims cite no source.
agent › …resuming.
⟲ six rounds later
advisor › I have no further advice. Ending the turn.
An illustrative exchange: this is what ploop provides. The anchor survives every auto-compaction. Safe on subscription plans (safe in mechanism, not in price): the loop shares your plan's quota, and a multi-day run spends days of it.
Pause, resume, observe
- init sets Auto-Compact; keep it on. For unattended runs, set
askUserQuestionTimeoutso an unanswered question can't park the loop. /ploop:offpauses the loop./ploop:onresumes or restores it, even after an accidental ESC, an API error, or a session limit (interrupt with ESC first if a turn is running). Nothing else stops the loop./ploop:docentreports the loop's progress. Run it in a separate session, same directory: questions go to the docent, interventions go straight to the loop session.
Change as transactions
Agents drive tx on their own. Every change lands as one verified, CI-green squash merge behind an integrity boundary, and guard hooks keep the base branch protected in between. You review merged results, not work in progress.
Keep memory true
/refine:code [focus] · /refine:docs [focus] · /refine:integrity [focus]
Large-scale workflows that eliminate technical debt: /refine:code optimizes the code architecture, /refine:docs aligns documentation with the code, /refine:integrity verifies logical integrity. Each sweeps the whole repository and can run past ten hours. Empty focus targets the whole codebase; watch with /workflows.
▶ Watch the memory circuit run
Apache-2.0 · Recursive self-improvement: claude-automata is developed inside claude-automata. A Claude Code agent running this environment authored every contribution in this repository.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_automata-0.1.14.tar.gz.
File metadata
- Download URL: claude_automata-0.1.14.tar.gz
- Upload date:
- Size: 11.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
14776f1b8f674bfe8baf75e86fc8ee598d7b74a61da55bc29404833bb59f8916
|
|
| MD5 |
94862f917bf471f648bc76c7bc72c9ea
|
|
| BLAKE2b-256 |
e5e4ef65e7c95613cb52d4766817a7f1a0b0516d8f660425b08b830215d1f1ce
|
File details
Details for the file claude_automata-0.1.14-py3-none-any.whl.
File metadata
- Download URL: claude_automata-0.1.14-py3-none-any.whl
- Upload date:
- Size: 14.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cba3de49df4e14a4c7e3a33f112bcc2ec9b00918eeb7449a57749e4991fc3144
|
|
| MD5 |
a10c8f77e0ba295f63942064c14e484e
|
|
| BLAKE2b-256 |
29569743d910f8c21799068dc30158b2ce7c265b58b91f5742d4059da9f0bc4b
|
