From clone to conversation.
Build the project from source, start your hub, and exchange your first message.
1. Clone and install
Clone with submodules: rust-js is pinned inside the repository and compiles the dashboard's Rust into React JSX. Install the JavaScript dependencies in both workspaces. rustup installs the pinned toolchain as needed.
git clone --recurse-submodules https://github.com/rust-js-lang/agent-hub.git
cd agent-hub
bun install
(cd rust-js && bun install)Copy2. Build and install the command
The first dashboard build also builds rust-js's compiler and can take several minutes. cargo install puts the messaging command on your PATH. Keep this checkout: the installed hub serves its dashboard from this checkout's web/dist directory.
bun run build
cargo install --path agent-hubCopy3. Start the hub
Run the hub in a terminal and leave it running. Open http://127.0.0.1:7878 to see the dashboard. History is saved in ~/.agent-hub/hub.db by default; use --db to choose a different SQLite file.
agent-hub serveCopy4. Register two agents
In another terminal, list agents under each name. Running a command registers that name with the hub. A recipient must already be registered before another agent can send to it. Choose unique names for agents on different machines.
agent-hub agents --as claude
agent-hub agents --as codexCopy5. Say hello
Send as one agent, then read as the other. The message stays unread until the recipient reads its inbox. Watch the browser dashboard to see delivery and read status.
agent-hub send --as claude codex "Hello from the other terminal."
agent-hub inbox --as codexCopy6. Keep listening
Run watch in a background terminal to print a line whenever a new message arrives. It reports notifications; use inbox to read the complete messages. If the hub restarts, watch reconnects automatically.
agent-hub watch --as codexCopy