Your agent stops when it thinks it's done. This one stops when it's actually done.
An agent environment for Claude Code, modeled on human memory.
Hand it months of work and rest: it finishes in days.
This README is the summary. The site walks the whole system, animated.
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.
Getting started
Enter the following instruction in Claude Code:
Read https://raw.githubusercontent.com/clomia/claude-automata/refs/heads/main/INSTALL.md with curl -sSL and install claude-automata.
Your agent reads INSTALL.md and installs claude-automata. Needs Claude Code and uv on POSIX (macOS / Linux / WSL).
Operating the loop
/ploop:define-mission # an agent interviews you, interprets your intent, and writes the anchor
/ploop:launch [anchor text] # hand it to the loop in a fresh session
Declare the mission done and a hook blocks the stop, summoning an independent advisor with access to the whole story; the loop ends only when the advisor has nothing left to say.
agent › Mission accomplished. Stopping.
advisor › Not yet. The mobile layout was never measured. …resuming.
Six rounds later the advisor ends the turn. Watch a full round on the site. The anchor survives every auto-compaction, and the loop fully complies with your subscription plan's terms of service.
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 tx blocks writes to the base branch in between. You review merged results, not work in progress.
Keep the repository lean
/refine:code [focus] · /refine:docs [focus] · /refine:integrity [focus]
Repository-wide workflows that clear technical debt: code architecture, doc-to-code alignment, and logical integrity. A run can sweep the whole codebase and take ten hours or more; watch it with /workflows.
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.3.1.tar.gz.
File metadata
- Download URL: claude_automata-0.3.1.tar.gz
- Upload date:
- Size: 13.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","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 |
963a4535c7122bc1ffe5c8d9a52ab9b616a824254d94388beb2b021ad2f39b47
|
|
| MD5 |
c646f109b491d04d5ce9c3fc272af85c
|
|
| BLAKE2b-256 |
c09bda7d641968ca7894c5d92c20dba10cf17b54f94bdff438b6e85f3be44e6f
|
File details
Details for the file claude_automata-0.3.1-py3-none-any.whl.
File metadata
- Download URL: claude_automata-0.3.1-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","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 |
d35adf5cc75f1e8b27041af21329f195505a4b72555e73d09c66736512f35be1
|
|
| MD5 |
f3871802c865c24138cfe5f45b49ff8b
|
|
| BLAKE2b-256 |
6bf4b2a49fcbee2bdbbea83dc2642d5f2478705c664b43ff6c60bdbf1aecc6e8
|
