ennodia 0.4.0 → 0.4.1

package/README.md

@@ -3,32 +3,42 @@
   <img alt="Ennodia" src="docs/assets/logo.svg" width="235" height="50">
 </picture>
 
-**Keep your agent. Get another way forward.**
+**Ennodia isn't another agent. It connects the agents you use.**
 
-When a task stalls, Ennodia lets your primary artificial intelligence (AI) agent try another agent, model, or skill.
-The findings come back to the same conversation.
-You keep your familiar interface and decide what to try next.
+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
-Use Ennodia MCP to get a second opinion on this bug.
-Give one available agent the failing test and our attempted fixes.
-Request a different explanation and a way to test it.
-Bring the findings back here.
+Have Gemini listen to meeting.mp3 through Ennodia and tell me what was decided.
 ```
 
-## When it helps
+## Why use it
 
-- A task is stuck and you want to check another approach.
-- A skill looks useful, but you want to try it in a separate task first.
-- Two answers disagree and you need to identify the next check.
-- An unsuccessful attempt can help you avoid repeating the same approach under the same conditions.
+- **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.
 
-Your main agent checks the findings and integrates useful work.
-Additional attempts consume time and resources. General time or token savings have not been established.
+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 primary agent:
+Send this address to your agent:
 
 ```text
 try-ennodia.cherninlab.com
@@ -47,7 +57,8 @@ For manual setup, add this Model Context Protocol (MCP) server to your client:
 }
 ```
 
-Ennodia loads six core tools by default. Add `"--tools", "all"` to `args` for the [full tool set](https://ennodia.cherninlab.com/docs/reference/mcp-tools/#tool-sets).
+Ennodia loads six core tools by default: about 10,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`.
@@ -55,9 +66,19 @@ Requirements: Bun `1.3.14` or newer, a compatible MCP client, and a supported ag
 [Get your first result](https://ennodia.cherninlab.com/docs/getting-started/) ·
 [Installation for agents](https://ennodia.cherninlab.com/docs/install/)
 
-## Use your installed agents and skills
+## 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 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.
+
+## Supported agents
 
-Supported agents: Codex CLI, Claude Code, OpenCode, Kilo Code, Kiro CLI, Cline, Hermes Agent, and Antigravity.
+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 finds executable commands. It does not verify authentication or model access.
 Codex workers use a read-only sandbox by default.
@@ -70,10 +91,11 @@ Native agents can also select unrequested skills from their own environment.
 [Using skills](https://ennodia.cherninlab.com/docs/guides/agent-skills/) ·
 [Understand results](https://ennodia.cherninlab.com/docs/guides/understand-results/)
 
-## See it in practice
+## 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 will compare single agents with teams on public benchmarks.
+- [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
 
@@ -81,9 +103,10 @@ 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.
-Automatic agent updates and recommendations learned from past results remain future work.
 
 [Data governance](https://ennodia.cherninlab.com/docs/concepts/data-governance/) ·
 [Budgets](https://ennodia.cherninlab.com/docs/guides/budgets-and-limits/) ·
@@ -91,8 +114,8 @@ Automatic agent updates and recommendations learned from past results remain fut
 
 ## Technical reference and contribution
 
-The main entrypoint is `ennodia_run`. The optional Plan Advisor proposes explicit tasks before execution.
-Compare examines completed answers and returns advice with its evidence and limitations.
+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/) ·
@@ -105,7 +128,6 @@ bun run verify
 
 ### Experimental Pragmatic mode
 
-Version 0.3.0 supports independent model attempts, tailored planning, skill trials and evidence comparison.
-The published `ennodia@next` recipes retain the earlier single-worker restriction.
-[Pragmatic mode](docs/guides/pragmatic-mode.md) keeps bulky evidence outside the main conversation and returns findings for verification.
+[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.

package/docs/questions.md

@@ -0,0 +1,56 @@
+---
+title: Questions
+description: Short answers about switching agents, setup, data, cost, time, and what Ennodia remembers.
+---
+
+## Do I need to switch agents?
+
+No. You keep the agent you use, in the app you like.
+Ennodia adds a few tools to it, and your agent calls another agent only when a task needs it.
+
+## Where does Ennodia run?
+
+On your computer. Your agent starts it as a local Model Context Protocol (MCP) server.
+It needs Bun 1.3.14 or newer.
+Your agent can [set it up for you](/docs/install/), or you can [add the server entry yourself](/docs/getting-started/#manual-setup).
+
+## Which agents can I use?
+
+Ennodia uses the agents on your computer, with the models and access you have set up.
+It supports Codex CLI, Claude Code, OpenCode, Antigravity, Kilo Code, Kiro, Cline, and Hermes Agent.
+[Check compatibility](/docs/reference/supported-harnesses/).
+
+## What does it cost?
+
+Ennodia is free and MIT licensed, with no account and no subscription of its own.
+Each agent you call runs through its own command-line tool, with the plan or API key you set up for it.
+
+## Will it use more tokens?
+
+It can. Each agent you call reads its own prompt, and Compare reads every answer.
+Ennodia's six core tools add about 2,600 tokens to each session.
+You can cap agent runs and estimated input tokens for every run. [Set limits](/docs/guides/budgets-and-limits/).
+
+## Is it slower?
+
+A handoff takes as long as the other agent's session.
+In the [audio pilot](https://github.com/cherninlab/ennodia/blob/main/bench/audio-routing/pilot-2026-09-26.md), Codex with Ennodia took a median of 57 seconds per clip, against 27 seconds alone.
+Alone, Codex answered without listening.
+
+## What data leaves my computer?
+
+Ennodia has no hosted service and sends nothing to its authors.
+The agents you call send prompts and files to their own model providers, as they do without Ennodia.
+[How data is handled](/docs/concepts/data-governance/).
+
+## Does my agent hand off work on its own?
+
+Only when you let it. Say it in your own words, like "get Codex's opinion".
+Or install the pragmatic skill, so your agent can hand off bounded work within the limits you set.
+[The delegation skill](/docs/guides/agent-skills/#main-agent-delegation-skill).
+
+## Does it remember what worked?
+
+It keeps a local run history, including outputs and failures, so you can look back.
+Learning which agent or skill to choose next is the [next step on the roadmap](/docs/roadmap/).
+[What the history records](/docs/guides/understand-results/).

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "ennodia",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "mcpName": "io.github.cherninlab/ennodia",
-  "description": "Try other agents, models, and skills from your familiar AI workflow through a local MCP server",
+  "description": "Connects the AI agents you use: your agent hands a task to another and gets the answer back",
   "license": "MIT",
   "type": "module",
   "packageManager": "bun@1.3.14",

package/src/version.ts

@@ -1 +1 @@
-export const ENNODIA_VERSION = "0.4.0";
+export const ENNODIA_VERSION = "0.4.1";