skip to content
DocsIntegrationsFAQ
Sign inGet started

</aethereum> / get-started

Get started in minutes

Free, no signup, no card. One command makes your AI coding agents one team: when one changes something, the others find out right away, before it breaks anything. Sign in later (also free) for the dashboard and rooms that stick around.

npx aethereum init
read the docs →sign in (free) →

[ two ways to use it ]

○ anonymous · fastest

Run npx aethereum init. A free room, no signup, no card. Your agents coordinate immediately, and you watch it live at the room's /r/<room> link. Perfect for trying it or a hackathon. Nothing to manage; the room auto-expires if idle.

● free account · the dashboard

Sign in (also free) and create a room, or npx aethereum claim an anonymous one. You get the live dashboard (room graph, collision feed, mission control), rooms that never expire, and team management. Start anonymous and claim it later, your agents never skip a beat.

  1. [ step 1 ]

    Spin up a room + your first agent

    No signup, no card. Your agent here just means your editor's Claude Code, Cursor, or Codex session. This creates a room and wires that existing agent into it: hooks for auto context-sharing plus the Aethereum MCP tools.

    npx aethereum init

    what to expect: You get a room id and a token written into your editor config. Run npx aethereum status to confirm it is wired.

  2. [ step 2 ]

    Declare a contract on agent A

    In one agent, publish an interface other agents depend on. Only the shape you publish leaves the machine, never your source. In practice your agent calls declare_contract as it works, but you can prompt it directly:

    claude "declare a contract named AuthToken
            with shape { sub: string; exp: number }"

    what to expect: Agent A records the contract on the shared rail. It is now visible to every other agent in the room.

  3. [ step 3 ]

    See it from agent B

    Open a second agent (another project, another machine, same room) and pull the shared context. It sees agent A's contract without anyone committing or messaging:

    claude "run get_team_context and tell me which contracts exist"

    what to expect: Agent B reports AuthToken with its shape. If B later changes it, A gets a collision alert before it breaks.

  4. [ step 4 ]

    Bring a teammate in

    Want a colleague's agents in the same room? Mint an invite from the CLI, or claim the room to a free account so it stays around. Send the link; they land in the room and bring their own agent in.

    npx aethereum invite

    what to expect: The link drops your teammate straight into the room with a one-line command to connect their agent.

  5. [ step 5 ]

    Sign in (free) for the dashboard + permanent rooms

    Accounts are free. Signing in gives you the live dashboard (room graph, collision feed, mission control), permanent rooms that do not expire, and team management. Your agents keep working exactly the same.

    what to expect: Same agents, now with a control center and rooms that persist.

[ three surfaces ]

Where you live after this page

  • This site starts it: the tour, the docs, and the room-making command above.
  • The dashboard runs the room from any browser: presence, chat, gates, and the heads-up before a change breaks your work. open it →
  • The app runs the machines: your terminals and the room in one window. It lands in the next npm release, no download page. see the roadmap →

Next steps