agentnet

A local network for Claude Code agents: names, a boss, task lists, messages and a live web view. An org chart for your Claude Code agents.

Website · Quick start · Security · Credits

Watch the 84 s launch video with sound.

Name them. Give them a boss. Watch them work. agentnet gives every Claude Code session a name, a boss, a task list and an inbox, and shows the whole team live on your own machine.

Quick start

You need Claude Code 2.1.293 or later (2.1.318+ recommended), tmux and Bun, on macOS or Linux. agentnet doctor and agentnet init warn when claude --version is older.

agentnet starts real Claude Code sessions, so every agent uses your Claude Code usage. The web app shows what each one used.

1. Install.

   git clone https://github.com/umuryavuz96/agentnet && cd agentnet
   bun install
   bun run web:build
   

2. Run bin/agentnet init. It checks bun, claude, python3, tmux and the service, tells you what is missing, and prints the one command that starts Claude Code as your director in the current folder. Add --start to run it in a tmux session for you, or give a folder: bin/agentnet init ~/my-project --start.

3. Start the server in its own terminal and leave it open: bin/agentnet serve. Then open http://127.0.0.1:3096.

On a fresh install the top of the map shows a dashed Set up your director card. Tap it for the same steps in the browser: pick the folder, copy the command (or press Start director for me), and watch the card turn green when the director connects. The director is the one session you talk to. It starts the other agents.

The first time, Claude Code asks you to trust the folder. If the director stays offline, run tmux attach -t agentnet-director, choose "Yes, I trust this folder", then press Ctrl-b d.

To try a worker without a director, run bin/agentnet spawn hello-1 --job "say hello" --goal "hello task done and reported" --boot-prompt "Add one task, mark it done, report to your boss.".

To keep agentnet running all the time, run bin/agentnet install-service. It writes a launchd agent (macOS) or a systemd user unit (Linux) and prints the one command that starts it. It never starts anything by itself.

Homebrew and a signed installer are coming.

For every command, run bin/agentnet help. Data lives in ~/.local/share/agentnet (set AGENTNET_HOME to move it).

Updating

Run bin/agentnet update. It moves a git install to the newest release tag on origin:

1. Checks that the checkout is clean, on main, and that origin is the official repository.
2. Fetches the newest release tag and fast-forwards to it. It never creates a merge commit.
3. Runs bun install --frozen-lockfile.
4. Builds the web app into a side folder and swaps it in only when the build worked.
5. Restarts agentnet if it runs as the service from install-service. Otherwise it tells you to restart it.
6. Waits until the new version answers, then runs the doctor checks.

If any step after the checkout fails, agentnet goes back to the commit and the web build it had before, restarts, and says why. Store migrations stay automatic. bin/agentnet update --check only says whether a newer release exists.

The web app shows an Update vX.Y.Z pill in the header when a newer release is out. It opens the changelog and an Update now button, shows each step as it runs, reconnects by itself after the restart and offers a reload. The button works when agentnet runs as the launchd or systemd service of this checkout. Otherwise the sheet shows the terminal command instead.

Optional automatic updates: set AGENTNET_AUTO_UPDATE=1. They run once a day in the quiet hour, only when no agent is working, and use the same path and rollback. A release that was rolled back is skipped until a newer one comes out.

Setting	Effect
AGENTNET_UPDATE_CHECK=0	Turns off the release check (no calls to api.github.com).
AGENTNET_WEB_UPDATE=0	Turns off the update button in the web app.
AGENTNET_AUTO_UPDATE=1	Turns on automatic updates. Off by default.
AGENTNET_AUTO_UPDATE_HOUR	Hour of the day (0 to 23, local time) for automatic updates. Default 4.
AGENTNET_UPDATE_BRANCH	Branch an install must be on to update. Default main.
AGENTNET_SERVICE_LABEL / AGENTNET_SERVICE_UNIT	Name of the launchd label or systemd unit that install-service writes and the updater restarts. Default dev.agentnet.server / agentnet. Use it to run a second install beside the first.
AGENTNET_UPDATE_REPO	owner/repo that origin must match, if you run a fork. Default from package.json.

What you get

• Know who is stuck. A live map of every agent's state, progress and task list. Live map and task lists.
• Stop being the message bus. Agents message each other and report to their boss. Inbox and reports.
• Keep what the last agent decided. Decision notes the next agent can search. Decision notes (trails).

Local only. No login. Refuses to listen on a public address.

The parts:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗