skip to content
~/docs~/skills~/faq

</aethereum> / get-started

Get started in minutes

Free, no signup, no card. One command gives your AI coding agents a shared brain: 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.

read the docs →sign in (free) →
  1. [ step 1 ]

    Spin up a room + your first agent

    No signup, no card. This creates a room and wires your editor's existing agent (Claude Code, Cursor, Codex, and more) 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 `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.

    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.

Next steps