agent-city-ai
v0.1.0
Published
Your AI coding agents (omp, Claude Code) as gangs in a real 3D city — runs locally on 127.0.0.1.
Maintainers
Readme
agent-city
Your AI coding agents as gangs in a real 3D city. Every omp or Claude Code conversation is a gang named after its session; its main agent is the Gang Lord and its subagents are the members. Watch them work on the streets of South Beach, ask them what they are doing, and message them from an in-game phone.

Run
npx agent-city-aiThis starts the agent-city daemon and the omp runner on your machine, serves the city on
http://127.0.0.1:4646/ and opens it in your browser. Ctrl+C stops everything.
Requirements: Node.js 20 or newer (or Bun). A browser with WebGL 2.
| Option | Effect |
|---|---|
| --port <n> | daemon port (default 4646, or $AGENT_CITY_PORT) |
| --no-open | do not open the browser |
| -y, --yes | answer yes to install/uninstall prompts |
Connect your agents
The city is empty until a runtime reports to it. Both commands show exactly what they will change and ask before writing; both back up any file they replace.
| Command | What it changes | Undo |
|---|---|---|
| npx agent-city-ai install-omp | copies one file, ~/.omp/agent/extensions/agent-city.js, which omp loads into every session (new sessions join; running ones after a restart) | npx agent-city-ai uninstall-omp deletes it (backup kept) |
| npx agent-city-ai install-claude | adds agent-city hooks to ~/.claude/settings.json (or $CLAUDE_CONFIG_DIR/settings.json); your other settings and hooks are kept; backup settings.json.<time>.agent-city.bak next to it | npx agent-city-ai uninstall-claude removes only agent-city's entries (backup kept) |
| npx agent-city-ai doctor | nothing: checks Node, the port, the token, omp and Claude Code, and what is installed | — |
omp sessions can be messaged and aborted from the city's phone, and gangs can be recruited from it (the
runner starts omp for you). Claude Code sessions are watch-only. Game actions (driving, weapons, police)
never touch your agents; only the phone does, and only when you click.
If you start the city with --port, run omp with the same AGENT_CITY_PORT and pass the same --port to
install-claude.
Privacy and cost
- Everything runs on your machine. The daemon binds
127.0.0.1only and refuses other hosts and origins. - No accounts, no telemetry, no API calls: the city (code, 3D models, textures, map data) is inside this package, nothing is downloaded at runtime, and agent-city sends nothing anywhere.
- Watching costs nothing: agent-city makes no model calls of its own. A message you send from the phone, or a gang you recruit, is an ordinary omp turn and is billed like anything you type into omp.
- What the city sees: session titles, working directories, models, tool calls, messages and cost, as reported by the omp extension and the Claude Code hooks. It is kept in the daemon's memory only and is gone when you stop it.
~/.agent-city/token(mode 600) authenticates the extension, the hooks and your browser tab to the daemon. The Claude Code hooks carry a token derived from it, not the token itself. Logs of the current run are in~/.agent-city/logs/.- Optional photoreal map: if you paste your own Cesium ion token in Settings, the browser streams Google Photorealistic 3D Tiles from Cesium ion with it. It is off by default; the default map is fully local.
Uninstall
npx agent-city-ai uninstall-omp
npx agent-city-ai uninstall-claude
rm -rf ~/.agent-cityCredits and licenses
- agent-city is MIT-licensed (
LICENSE), © Tal Mogendorff. - 3D models, textures and the HDRI are CC0 or CC BY 4.0; every asset, its author and its license are listed
in
dist/ASSET_CREDITS.md. - Map data © OpenStreetMap contributors, available under the Open Database License 1.0 (ODbL): see
ODBL_NOTICE.md. - Bundled npm packages and their licenses:
dist/THIRD_PARTY_NOTICES.md.
agent-city is an independent project inspired by open-world crime games. It is not affiliated with, endorsed by or connected to Rockstar Games or Take-Two Interactive, and uses no names, assets, fonts or audio from any commercial game.
