Reference and help / Release notes
Release notes
Ekamyth Agent OS 0.1.36rc14 (build 599c5e120c18), 17 Nov 2026.
Welcome to the Ekamyth Agent OS beta. This is an early build, and we want to hear what breaks, what confuses you and what you would change.
Agent OS sits between your coding agents (Claude Code and Codex) and their models. It checks what they do, enforces your rules, chooses the model and shows you what each call cost. Your prompts and responses go only to your model provider; Ekamyth receives none of them.
What's in this beta
Install and setup
- Install on macOS or Linux (Python 3.10 or later) with the one-line command from your account page. Each command works once, for 60 minutes.
hero setupconnects Claude Code and Codex.hero setup --undoputs both back the way they were.
Agent OS (the hero command and the local proxy)
- Governance on every tool call, in Claude Code and Codex. By default it records what your agents do and stops a short list of catastrophic or protected actions, such as deleting your home folder, force-pushing or reading your keys. Anything held for you waits in
hero inbox; once you approve it, your agent can run it. - Your rules, enforced.
hero init CLAUDE.mdregisters the rules in your project's CLAUDE.md or AGENTS.md; run it again after you add rules.hero enforcelists every rule, says whether it is enforced as code in Claude Code and in Codex, and gives one next step. - Model routing. Routing is on by default and knows Claude Sonnet 5.5, Opus 5.5, Fable 5.1 and Fable 5.2 at public list prices. A Claude Code call routed to another model is answered by the model it was moved to.
hero routeshows which calls moved and why. - Cost.
hero efficiencyshows what each call and each session cost, and Monitor shows the same figure. - Trace.
hero tracelists your agent sessions with their steps, outcome, tokens and cost. - Proof.
hero attest verifychecks the tamper-evident record of what your agents did. If even one byte has been changed, it tells you. - Brain (experimental). Save a work checkpoint in Claude Code or Codex and pick it up again in the other agent.
Monitor
- Run
hero portal opento open Monitor. It is served on your machine only and opens on Overview, Health and Telemetry; Telemetry has views for usage, routing, reliability, outcomes, evidence, governance and traces.
Control
- Control › You shows your governance, budget, tools and data. In the beta, Control is view-only.
Known issues
Governance
- The always-on safety check stops the plain catastrophic commands and many roundabout forms, but not all of them yet: a command hidden by encoding, a command spelled with look-alike Unicode letters, a script or program file written first and run later, a dangerous command on its own line after a harmless one, and edits to a login item's settings file made with PlistBuddy or plutil. Those still reach your agent's own permission prompt.
- Secret files such as SSH keys, cloud credentials and
.envfiles can still be read by a search, in Claude Code's built-in Grep and Glob tools or agrepcommand in either agent. Claude Code's built-in Write and Edit tools can also change Ekamyth's own hook, rule and record files. Review your agent's permission prompts for these. - A file your agent writes that runs later, such as a git config setting, a package script or a CI workflow, isn't checked when it runs. Review agent edits to those files.
- If Claude Code times out or stops Ekamyth's safety check on a tool call, that one call runs unchecked.
- In Codex, if more than about a minute passes between your approval and the action running, Codex can ask for approval again. Approve it once more in
hero inbox. - A harmless command can be held for your approval, for example
ls, or a search for the text "rm -rf". Approve it inhero inbox.
Your rules
- Write each standing rule starting with Never or Always. A rule worded "Under no circumstances …" or "You must never …" isn't saved.
- In a "Never change files under <folder>" rule, don't end the folder name with a period; with the period the rule blocks nothing.
- When a rule blocks a call, the block happens and
hero traceshows it, but rule counts can still show 0. Rule totals and states can also differ betweenhero enforce,hero codify,hero statusand Monitor, and a rule Ekamyth is only watching can be shown as enforced.hero traceshows what was actually blocked. The message at the start of a session can also say a rule isn't armed when it is. hero enforcecan answer "machine is busy". Run it again.
Routing and cost
- Route savings can show as "not measured".
- When the provider rejects a routed call (for example a rate limit), Ekamyth retries it on your original model, but
hero routelists the call as "kept".
Trace
- A tool call that failed can still show as ✓ ok in
hero trace. - On a machine with several weeks of history,
hero trace list,hero healthandhero routecan take up to a minute to answer.
Monitor
- Some Monitor counts (rule coverage, pending approvals, governance tiles, budget status, "No model calls") can differ from the CLI. Trust the CLI:
hero enforce,hero inbox,hero govern statusandhero efficiency. - Monitor can say "quality held in Ekamyth's evals" for a routed call whose quality hasn't been measured yet.
hero routeshows the call's own status. - In Monitor › Recent receipts, "✓ governed" means Ekamyth allowed the call, not that it succeeded.
Proof
hero attest exportcan refuse on a machine where Codex has run.hero attest verifystill checks the record.
Privacy and memory
- After you opt in to learning,
hero privacynames the wrong destination for decision and usage metadata: it goes to Ekamyth's learning service. hero memorycan say no rules were dropped when some didn't fit in the context budget.
Brain
- Opening the Brain page can save the example notes as your own; edit or delete them in Brain. After
hero brain init, resuming a thread may fail.
Install and setup
- Before this machine is activated,
hero setupcan exit with an error; runhero setup redeem <Install id>instead.
How to install and give feedback
- Install: sign in at ekamyth.ai/account, choose Get an install command and run that command in Terminal. On Linux, run it with
bash -c, notsh -c. If you skip activation during the install, runhero setup redeem <Install id>later. - Update: get a new install command from ekamyth.ai/account (each one works once, for 60 minutes) and run it. Your rules and records are kept.
- Remove:
curl -fsSL https://install.ekamyth.ai/uninstall.sh | sh. Your data in~/.herostays until you delete it. - Feedback: email support@ekamyth.com.
Checked against Agent OS 0.1.36rc14 (build 599c5e120c18) on 17 Nov 2026.