claude-automata

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

claude-automata

★ 13 Open GitHub ↗

An autonomous agent environment for Claude Code. 24/7 full self-driving: delegate everything and rest.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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 | [한국어](https://github.com/clomia/claude-automata/blob/main/README.ko.md)

---

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](https://github.com/clomia/claude-automata/blob/main/INSTALL.md) and installs claude-automata. Needs [Claude Code](https://claude.com/claude-code) and [uv](https://docs.astral.sh/uv/getting-started/installation/) 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.](https://claude-automata.clomia.com/#advisor) The anchor survives every auto-compaction, and the loop fully complies with your subscription plan's terms of service.

<details>
<summary>Pause, resume, observe</summary>

- init sets Auto-Compact; keep it on. For unattended runs, set `askUserQuestionTimeout` so an unanswered question can't park the loop.
- `/ploop:off` pauses the loop. `/ploop:on` resumes 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:docent` reports the loop's progress. Run it in a **separate session, same directory**: questions go to the docent, interventions go straight to the loop session.

</details>

## 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.

claude-automata

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README