Ekamyth Agent OS documentation
Agent OS is the operating system layer for AI agents. It works with the agents you already use, Claude Code and Codex, on Mac and Linux.
What Agent OS is
Agent OS runs on your machine, beside Claude Code and Codex. You keep your agent and your own model provider. Agent OS checks your agents' tool calls against the rules you write before they run, keeps a Brain of what you've asked it to remember and gives your agent the part that fits each session, routes your agents' model calls, looks for waste across the whole of the work, and keeps a record of what your agents did that you can read. It connects through the model gateway, hooks in Claude Code and Codex, an MCP wrapper you set up per server, 12 skills inside your agent, and the hero commands in your terminal.
Your agent's MCP tool calls reach Agent OS through its hooks by default, like its other tools. For a server you want checked call by call before it's reached, you set up the MCP wrapper for that server. See How MCP works.
Agent OS is in beta, open to all.
Documentation by area
Agent OS is a standard operating system, plus discipline for probabilistic workers. Each area starts with a page on how it works, then a page for each command.
Standard OS · what every OS does
Added for agents · discipline for probabilistic workers
Reference and help
hero command, and a task index: "I want to ...".FAQWhat Agent OS is, what each area does, and how it compares.TroubleshootingSymptoms, causes and fixes, starting with hero status.
Where to start
The main path, in order:
- Get started: install Agent OS and connect Claude Code and Codex.
- Check coverage: what reaches Agent OS on each agent.
- See a real decision: watch the hook refuse a risky command, then work through the other things to try.
- Troubleshoot: symptoms, causes and fixes, starting with
hero status.
| I want to | Go to |
|---|---|
| Understand how Agent OS works | How Agent OS works |
| Install it and connect my agents | Get started |
| Try it out and see what it does | Things to try |
| Find the command for a task | Find by task |
| Fix something that isn't working | Troubleshooting |
| Read answers to common questions | FAQ |
Checked against Agent OS 0.1.36rc14 (build 599c5e120c18) on 17 Nov 2026.