Ekamyth Agent OS docs
Agent OS documentation

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.

On your machine, your agent's model calls pass through the Agent OS model gateway to your own provider, and its hooks call Agent OS at set moments such as before a tool call. What you get: rules checked as code, a Brain, routing, efficiency, a record and MCP.
Agent OS sits between your agent and your model provider, on your machine. See How Agent OS works.

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

Where to start

The main path, in order:

  1. Get started: install Agent OS and connect Claude Code and Codex.
  2. Check coverage: what reaches Agent OS on each agent.
  3. See a real decision: watch the hook refuse a risky command, then work through the other things to try.
  4. Troubleshoot: symptoms, causes and fixes, starting with hero status.
I want toGo to
Understand how Agent OS worksHow Agent OS works
Install it and connect my agentsGet started
Try it out and see what it doesThings to try
Find the command for a taskFind by task
Fix something that isn't workingTroubleshooting
Read answers to common questionsFAQ

Checked against Agent OS 0.1.36rc14 (build 599c5e120c18) on 17 Nov 2026.