Skip to main content
Glama
README.md
<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
  <img alt="Ennodia" src="docs/assets/logo.svg" width="235" height="50">
</picture>

**Ennodia isn't another agent. It connects the agents you use.**

Stay in Codex, Claude Code, or any agent you like.
When a task needs another model, your agent hands that part over through Ennodia and brings the answer back.
Ennodia runs on your computer, and each agent uses your own account.

```text
Have Gemini listen to meeting.mp3 through Ennodia and tell me what was decided.
```

## Why use it

- **Keep the app you like.** Ennodia has no window of its own. You work in your agent as before, and it can now reach the others.
- **Your agents work together.** Any agent can hand part of a task to any other and get the answer back in your chat.
- **Nothing to pay, nothing to join.** Ennodia is free and open source, with no account. It uses the agents and plans you have.
- **It grows with your agents.** It is a set of tools, not a framework or a method. Each new model one agent gains becomes an ability for all of them.
- **It stays on your computer.** Every handoff leaves a receipt there: who did the work, how long it took, and what came back.
- **Less to keep up with.** You don't need to follow every new model. Name the task, and your agent hands it to one that can do it.

Next on the [roadmap](https://ennodia.cherninlab.com/docs/roadmap/): Ennodia reads its receipts, so your agent stops repeating what failed.

## What each agent adds

No model leads every task, so each agent you connect brings an ability the others lack.

- **Listen.** Gemini hears audio files. Codex hands it the file path and gets back what Gemini heard.
- **Draw.** Codex draws with GPT Image. Claude Code can hand it a brief and get the images back.
- **Review.** Two other agents review the same patch in fresh sessions. Compare maps where they agree and differ.
- **Read.** Kimi K3 in OpenCode reads long documents. Your agent hands it a spec and gets back the rules, each with its line number.

When your own agent has the ability, it does the task itself, with no handoff.
[See each route](https://ennodia.cherninlab.com/#abilities) and the [public scores behind each strength](https://ennodia.cherninlab.com/#evidence).

## Install

Send this address to your agent:

```text
try-ennodia.cherninlab.com
```

For manual setup, add this Model Context Protocol (MCP) server to your client:

```json
{
  "mcpServers": {
    "ennodia": {
      "command": "npx",
      "args": ["-y", "ennodia"]
    }
  }
}
```

Ennodia loads eight core tools by default: about 13,000 characters of tool definitions in each session.
Add `"--tools", "all"` to `args` for the [full tool set](https://ennodia.cherninlab.com/docs/reference/mcp-tools/#tool-sets).

Requirements: Bun `1.3.14` or newer, a compatible MCP client, and a supported agent with working provider access.
`npx` downloads Ennodia. Bun runs it. You can also use `bunx ennodia`.

[Get your first result](https://ennodia.cherninlab.com/docs/getting-started/) ·
[Installation for agents](https://ennodia.cherninlab.com/docs/install/)

## How a handoff works

1. Your agent calls `ennodia_run` with the task, the agent or model to use, and a time limit.
2. Ennodia checks the selected route, then starts that agent's own command-line tool in a fresh session, with its own tools and your account for it.
3. The answer comes back to your conversation, with its status and a receipt saved on your computer.

Your conversation history stays in your agent.
For two or more answers, Compare maps agreements, contradictions, and gaps.
When one answer is complete as it stands, Compare can choose it, and `ennodia_run` returns it unchanged.

Include relevant constraints and prior decisions in your task prompt under **Keep in mind**.
Ennodia asks workers and Compare to return useful reminders with reasons and evidence.
Your agent verifies them before carrying them into the next task.
See [how to read these notes](https://ennodia.cherninlab.com/docs/guides/understand-results/#keep-in-mind).

## Supported agents

Codex CLI, Claude Code, OpenCode, Kilo Code, Kiro CLI, Cline, Hermes Agent, and Antigravity.
Model availability and tool permissions depend on the installed agent and its provider configuration.
Discovery reports native login checks and confirmed recovery actions. The requested task verifies model access without a separate model call first.
Codex workers use a read-only sandbox by default.

Ennodia discovers native Agent Skills and can request them for specific tasks.
A separate task keeps the trial outside the main conversation.
Native agents can also select unrequested skills from their own environment.

[Recipes](https://ennodia.cherninlab.com/docs/guides/recipes/) ·
[Using skills](https://ennodia.cherninlab.com/docs/guides/agent-skills/) ·
[Understand results](https://ennodia.cherninlab.com/docs/guides/understand-results/)

## Evidence

- [Can Gemini hear this file?](https://ennodia.cherninlab.com/articles/can-gemini-hear-this-file/): a Codex conversation hands an audio file to Gemini through Antigravity.
- [Measurement plan](https://ennodia.cherninlab.com/docs/evidence/measurement/): how Ennodia compares single agents with teams on public benchmarks.
- [Audio routing pilot](bench/audio-routing/pilot-2026-09-26.md): Codex got 10 of 10 speech questions right through Gemini, and 4 of 10 alone. Across all 30 clips the gain was not significant, and each answer took about twice as long.

## Data and limits

Ennodia runs locally without an Ennodia-hosted service.
Selected agents can send material to their configured model providers.
Terminal run history is stored locally and can be disabled with `ENNODIA_HISTORY=0`.

Each handoff costs time and uses your agents' own quotas and charges.
General time or token savings have not been established.
Ennodia can limit child tasks and estimated input tokens.
Those estimates exclude internal harness work and are not provider bills.

[Data governance](https://ennodia.cherninlab.com/docs/concepts/data-governance/) ·
[Budgets](https://ennodia.cherninlab.com/docs/guides/budgets-and-limits/) ·
[Roadmap](https://ennodia.cherninlab.com/docs/roadmap/)

## Technical reference and contribution

The main entry point is `ennodia_run`.
The full tool set adds raw tasks, separate Compare calls, budget estimates, and the Plan Advisor, which proposes explicit tasks before execution.

[MCP tools](https://ennodia.cherninlab.com/docs/reference/mcp-tools/) ·
[Experimental Ennodia IO](https://ennodia.cherninlab.com/docs/reference/ennodia-io/) ·
[Contributing](CONTRIBUTING.md) · [MIT license](LICENSE)

```sh
bun install
bun run verify
```

### Experimental Pragmatic mode

[Pragmatic mode](docs/guides/pragmatic-mode.md) runs independent model attempts, tailored plans, and skill trials, then compares the evidence.
It keeps bulky evidence outside the main conversation and returns findings for your agent to verify.
Savings are not yet validated.

## Login recovery and updates

Ennodia checks selected workers, Judge, and Advisor routes before execution.
Blocked routes return a native recovery action before reviewers start.
Ennodia says nothing about its own status unless an agent you asked for is blocked.
Rechecks and blocked starts return compact diagnostics. The full setup panel appears only for an explicit setup request.

Your agent calls `ennodia_setup` to show each agent's status and fix in your current session.
Hosts that render MCP Apps, such as Claude Desktop and Visual Studio Code, can show it as a card with check buttons.
Other hosts, such as Codex and Claude Code, show the Markdown panel.

Run that action in an interactive terminal, then call `ennodia_check_harnesses` with the same harness and model and `refresh: true, verify: true`.
Run receipts keep missing reviewer coverage visible, including in compact responses.

Supported harness upgrades run once per day on use while Ennodia has no active tasks.
Set `ENNODIA_AUTO_UPDATE=false` to disable them.
Use `ennodia_check_harnesses` with `upgrade: true` to update and recheck immediately.

Ennodia also checks its own installation automatically. Run results report the loaded code location, version, runtime, and installation scope. The report checks required files, bundled skills, and storage access. The recheck tool refreshes this report. MCP startup instructions carry only installation problems.

Mention installation limitations when they affect the request. Cache installs can change on a future unpinned launch. These local checks do not verify the latest registry version or provider access.
See [recovery and updates](https://ennodia.cherninlab.com/docs/reference/supported-harnesses/#recovery-and-updates).

TDQS

A3.9/5.0

Scored across 6 tools

Disambiguation4/5

Each tool has a distinct lifecycle role: list_harnesses/list_skills are discovery, run starts work, get_run reads status, history reads past receipts, cancel_run stops work. The only mild overlap is get_run vs history (live vs persisted) and run vs list_harnesses routing guidance, but descriptions clarify these boundaries.

Naming Consistency4/5

All tools use the ennodia_ prefix with snake_case verb_noun naming, which is highly consistent. Minor deviation: ennodia_run is a bare verb with no noun, while others include an object (enumodia_list_harnesses, ennodia_get_run).

Tool Count5/5

Six tools is well-scoped for an orchestration server, covering discovery, execution, polling, history, and cancellation without redundancy. Each tool earns its place in the run lifecycle.

Completeness4/5

The lifecycle is well covered: discover harnesses/skills, start run, poll, cancel, and read history. Minor gap: no explicit tool for listing or retrieving an in-progress run's result beyond polling, but get_run with waitMs handles terminal results adequately.

Maintenance

ActivityNo data
ResponsivenessOutdated data