All guides

COLONYYou commented this keyword

Bot Crossing

Every coding-agent thread on your computer becomes a small bot building on a 3D map, and the ones that need you hold up a question mark.

Before you start:
  • Node.js 22.13+
  • Claude Code or another supported agent
Setup
5 min
Level
Intermediate
Stars
777
License
MIT

What it does

Bot Crossing turns your agent threads into a colony. Each repo gets a plot of land, each session is a bot with a building, and a bot that needs your input stops and shows a question mark. Click it and the thread opens in the app it came from.

It reads the session files already on your computer. Nothing is uploaded, there is no account, and it never writes to Claude Code or any other tool. It supports Claude Code, Codex, OpenCode, Antigravity CLI, Cursor, Hermes and Kilo Code.

Install it

  1. Install Node.js 22.13 or newer.
  2. Get a copy of the repo from GitHub and open a terminal in that folder.
  3. Run the command below. It installs everything and starts the app.
  4. Open the local address it prints in your browser.

Copy this

Terminal
npm install && npm run dev

Use it

  1. Look for bots holding a question mark. Those threads are waiting on you.
  2. Click a bot, a zone or a repo in the right-hand panel to see what is running there.
  3. Press C, or click New conversation, to start a fresh Claude Code thread in that repo.

Good to know

Works on macOS, Linux and Windows. It only listens on your own computer by default. The author built it for personal use and says it is published as-is, so issues may go unanswered.

Links

Want the next one first?

One new guide a week, straight to your inbox.

More like this