Portable, stage-gated agentic-AI harness for Claude Code, Codex, and OpenCode.
An AI coding agent framework that gives LLM-powered development tools structured workflows for long-running tasks. Automaton installs markdown skills, lightweight startup integrations, and durable .agent/ state into a project so agent work survives context window limits, session restarts, and multi-step changes that would otherwise lose coherence.
🖤🤍💛 Thanks to Linux Do (https://linux.do/) for their vibrant AI development community. 🖤🤍💛
- Keep project truth, current work, and handoff state outside the chat window.
- Move larger changes through explicit frame, plan, execute, and verify stages.
- Use the same workflow across Claude Code, Codex, and OpenCode.
Run from the project you want to equip:
npx @appautomaton/automaton install --codex
npx @appautomaton/automaton install --claude
npx @appautomaton/automaton install --opencodeInstall all supported host surfaces:
npx @appautomaton/automaton install --allThe target root is optional and defaults to the current directory. To install into another project, pass its path as the final argument.
.agent/durable project state, steering, work artifacts, and runtime files- host skills under
.codex/skills,.claude/skills, or.opencode/skills - host hooks/plugins for context injection
Automaton is copy-based: installed skills are local plain markdown files that are refreshed from source on reinstall and can be inspected in the target project.
office-hours -> frame -> product review -> plan -> engineering review -> execute -> verify -> resume
Most changes start at auto-frame, move through auto-plan, then continue with auto-execute and auto-verify. Use auto-onboard when project steering is missing or stale, and auto-office-hours when the objective is still too broad.
Run package commands through npx @appautomaton/automaton:
npx @appautomaton/automaton status
npx @appautomaton/automaton validate
npx @appautomaton/automaton install --uninstall --codexContributor-only design and runtime notes live in the repository docs/ directory; they are not included in the npm package payload.
MIT