https://github.com/appautomaton/automaton
AI coding agent framework — portable, stage-gated harness for Claude Code, Codex, and OpenCode
https://github.com/appautomaton/automaton
agent-skills agentic-workflows ai-agents ai-coding-assistant automation claude-code cli-tool codex context-window developer-tools llm npm-package opencode prompt-engineering workflow
Last synced: 1 day ago
JSON representation
AI coding agent framework — portable, stage-gated harness for Claude Code, Codex, and OpenCode
- Host: GitHub
- URL: https://github.com/appautomaton/automaton
- Owner: appautomaton
- License: mit
- Created: 2026-05-01T03:08:30.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-22T23:51:48.000Z (about 1 month ago)
- Last Synced: 2026-05-23T01:24:43.335Z (about 1 month ago)
- Topics: agent-skills, agentic-workflows, ai-agents, ai-coding-assistant, automation, claude-code, cli-tool, codex, context-window, developer-tools, llm, npm-package, opencode, prompt-engineering, workflow
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/@appautomaton/automaton
- Size: 301 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Automaton
[](https://www.npmjs.com/package/@appautomaton/automaton)
[](https://github.com/appautomaton/automaton/blob/main/LICENSE)
[](https://www.npmjs.com/package/@appautomaton/automaton)
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.
## Acknowledgement 致谢
🖤🤍💛 Thanks to [Linux Do](https://linux.do/) (https://linux.do/) for their vibrant AI development community. 🖤🤍💛
## Why Use It
- 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.
## Install
Run from the project you want to equip:
```bash
npx @appautomaton/automaton install --codex
npx @appautomaton/automaton install --claude
npx @appautomaton/automaton install --opencode
```
Install all supported host surfaces:
```bash
npx @appautomaton/automaton install --all
```
The target root is optional and defaults to the current directory. To install into another project, pass its path as the final argument.
## What It Adds
- `.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.
## Workflow
```text
office-hours -> frame -> product review -> plan -> engineering review -> execute -> verify -> verified
```
Most changes start at `auto-frame`, move through `auto-plan`, then continue with `auto-execute` and `auto-verify`. A full verification pass closes the change as `verified` (terminal). Use `auto-onboard` when project steering is missing or stale, `auto-office-hours` when the objective is still too broad, and `auto-resume` to re-enter existing work from a fresh session at any point.
## Useful Commands
Run package commands through `npx @appautomaton/automaton`:
```bash
npx @appautomaton/automaton status
npx @appautomaton/automaton validate
npx @appautomaton/automaton install --uninstall --codex
```
## Contributor Docs
Contributor-only design and runtime notes live in the repository [`docs/`](docs/) directory; they are not included in the npm package payload.
## Links
- [npm package](https://www.npmjs.com/package/@appautomaton/automaton)
- [GitHub](https://github.com/appautomaton/automaton)
- [Issues](https://github.com/appautomaton/automaton/issues)
## License
MIT