aethereum

aethereum

The coordination layer for AI coding agents. Make every developer's agents one team: when your team runs Claude Code, Cursor, or Codex across different machines, their agents share interface contracts, intent, and breaking-change alerts, and they negotiate interface changes before they break each other.

→ Full product, docs, and live dashboard: www.aethereum.dev

Quickstart

One command, no signup:

npx aethereum init

That creates a free room, wires your agents (Claude Code, Cursor, Codex, Windsurf, Cline, Zed) over MCP + hooks, and seeds a shared project brief. Then just open your agent in that folder and use it as you normally would, it shares your team's context automatically.

npx aethereum join <code>   # a teammate joins your room
aethereum login             # sign in (approve in your browser) to keep rooms + invite your team

What it does

Three things break when a team runs multiple AI agents across machines:

• Context drift: everyone's agents run on different docs, rules, and state.
• Shadow dependencies: one agent refactors a contract, another never hears, the integration breaks.
• Device fragmentation: switch machines and the agent state is gone.

Aethereum is the coordination layer that fixes all three. The flagship is the interface-contract negotiation handshake: one agent proposes a shape change, a dependent on another machine pushes back, and it only lands once reconciled. Everyone else just notifies; here agents negotiate.

Your source code never leaves your machine. Aethereum stores only the contracts, intent, and decisions an agent explicitly publishes.

The session layer

Your agents' sessions, captured locally and never uploaded. Transcripts contain your code, so they stay on your machine; anything that moves is numbers (opt-in) or ciphertext.

aethereum sessions                   # every captured session: agent, branch, tokens, est cost
aethereum sessions search "auth bug" # full-text search your local sessions
aethereum sessions replay <id>       # one self-contained HTML replay, generated locally
aethereum usage --week --by-model    # tokens + estimated cost (estimates, verify your bill)
aethereum handoff                    # move a session to another machine, end-to-end encrypted
aethereum resume-handoff             # ...and resume it there with full history
aethereum distill --scan             # find the friction in your sessions, zero network calls
aethereum statusline install         # session burn + live team signals in Claude Code
aethereum check --strict             # block commits that touch frozen/negotiating contracts

Any MCP agent

Point any MCP-speaking agent at the hosted endpoint:

{ "mcpServers": { "aethereum": { "type": "http", "url": "https://www.aethereum.dev/api/mcp" } } }

Learn more

• Website: https://www.aethereum.dev
• Docs: https://www.aethereum.dev/docs
• Integrations: https://www.aethereum.dev/integrations

Made by Bruno Jaamaa. Aethereum is a hosted product; this package is its CLI client.