AI product Open source

Bot Crossing

Bot Crossing is a local web application that visualizes coding-agent threads as an astronaut colony. It reads session records from installed agent harnesses on the user's machine, maps repositories to persistent hex zones, and represents sessions as astronauts whose behavior reflects states such as running, waiting, errored, merged, archived, or inactive. Selecting an astronaut or repository opens its associated thread through the owning harness, while the application can also start sessions, reveal folders, mark threads viewed, and archive them.

View repository Visit site Mentioned in 2 videos ↓

Overview

The application uses per-harness adapters to scan local session files and merge them into a common thread model. It currently documents support for Claude Code, Codex, and Cursor, with adapters for other harnesses able to be added under `server/harnesses/`. Astronaut navigation uses a rasterized navigation grid, A* routing, string-pulling, collision handling, and crowd separation. The browser renders the colony with Three.js techniques including instanced GPU-skinned astronauts, shader-based construction progress, procedural terrain and surfaces, and configurable planets, lighting, and quality settings.

Bot Crossing runs locally through a Vite development server or a built Node server, binds to loopback by default, and stores the colony layout in `data/colony.json`. It does not upload session data or use an account; it reads harness records and writes only the colony state plus the documented archive field. The repository requires Node 22.13 or newer, supports macOS, Linux, and Windows, and is licensed under MIT. Bundled Kay Lousberg assets are separately covered by CC0, while bundled Material Design Icons use Apache-2.0.

What Bot Crossing is used for

2 uses taken from transcripts — each links to the moment in the video.

  • Visualizes coding-agent sessions as an astronaut colony, showing whether each session is working, stuck, or waiting. It reads local session files and lets users reopen the original thread.

  • A local dashboard and video game that visualizes AI agent sessions as an Animal Crossing-style colony. Agents appear as hex tiles and jobs as astronauts with visual statuses such as working, waiting for input, or stuck.

Videos mentioning Bot Crossing

2 in the library.