Your Claude Code projects as a living 3D town

Every project is a room, every folder a building, and live sessions walk around in it. Runs entirely on your computer.

curl -fsSL https://getdevon.pages.dev/install.sh | bash

Paste into Terminal

Overview

DevOn scans the Claude Code projects on your computer and draws them as a small town in the browser.

The whole town: buildings are folders, rooms are projects, and the activity feed shows what each session is doing.

Every project is a room with a desk for Claude sessions, desks for the project's own agents and a meeting table for guests. Skills, MCP servers and commands appear as a bookshelf, a server rack and a notice board.
Every folder is a building. A folder holding several projects becomes a building with corridors; streets, cars and pedestrians run between buildings.
The lobby is your global ~/.claude: global staff agents, the skills shelf and hooks.
Live mode shows which room has a running session, which tool is in use, where a subagent went and who is waiting for permission.
Morning and night themes, and three languages: Uzbek, English, Russian.

Click a room to see its sessions, agents, skills and MCP servers, and to open a terminal or a new Claude session there.

DevOn listens only on 127.0.0.1. Nothing leaves your computer.

Install

One command installs DevOn, adds the devon command and starts it.

curl -fsSL https://getdevon.pages.dev/install.sh | bash

Paste into Terminal

What the installer does:

Downloads the DevOn package and verifies its SHA-256 checksum.
Looks for Node.js 20 or newer. If there is none, it downloads a private copy into ~/.devon/runtime; your system is not changed.
Adds the devon command to your PATH.
Starts DevOn in the background and opens http://127.0.0.1:4777.

From then on, open a terminal and type:

devon

Requirements

	Supported
macOS	Intel and Apple Silicon
Linux	x64 and arm64 (glibc distributions)
Windows	Windows 10 (1803 or newer) and Windows 11
Claude Code	Installed and used at least once, so `~/.claude` exists
Browser	Any modern browser with WebGL
Node.js	Optional. Version 20+ is reused if present, otherwise installed for you

How it works

DevOn is a small local web server plus a 3D page. It only reads Claude Code's own files; it does not talk to Claude or to any network service.

Claude Code files~/.claude, running sessions and your project folders
DevOn serverLocal process on 127.0.0.1:4777. Rescans every 60 seconds and streams live changes
Your browserDraws the town in 3D and updates it as sessions work

What is read, and why:

Source	Used for
`~/.claude.json`	The list of projects Claude Code has been used in
Scan folders	Projects that contain `.claude/` or `CLAUDE.md`
`.claude/agents`, skills, MCP, commands	Desks and furniture in each room and in the lobby
`~/.claude/sessions/*.json`	Which sessions are running right now, and where
Hook events (optional)	Tool in use, subagents, waiting for permission

Installed files:

Path	Contents
`~/.devon/app`	DevOn itself (replaced on update)
`~/.devon/runtime`	Private Node.js, only if your system had none
`~/.devon/bin/devon`	The `devon` command
`~/.devon/office.config.json`	Your settings (kept on update)
`~/.devon/devon.log`	Server log

The devon command

Everything is managed with one command. Without arguments it is the same as devon start.

Command	What it does
`devon`	Start DevOn in the background and open it in the browser
`devon stop`	Stop the background server
`devon restart`	Stop, then start again
`devon status`	Show whether DevOn is running
`devon open`	Open the DevOn page in the browser
`devon hooks install`	Turn on the live hook (tools, subagents, permission waits)
`devon hooks uninstall`	Turn the live hook off
`devon update`	Download and install the latest version
`devon uninstall`	Stop DevOn, remove the hook and delete `~/.devon`
`devon version`	Print the installed version
`devon help`	List all commands

Live hook

Sessions are visible without any setup. To also see tools, subagents and "waiting for permission", turn on the hook:

devon hooks install

It adds one entry to your Claude Code settings.json (a backup copy is written first) and leaves your other hooks alone. To remove it:

devon hooks uninstall

The hook is asynchronous, prints nothing and always exits with 0, so Claude Code is unaffected even when DevOn is stopped. It sends metadata only: event name, session id, folder, tool name and agent type. Never prompts, tool input or tool output.

Room actions

Click a room to open its panel. The Actions section can start things in that project's folder:

Action	macOS	Linux	Windows
Claude session	Terminal.app	Your terminal emulator	New console window
Terminal	Terminal.app	Your terminal emulator	PowerShell
Folder	Finder	File manager (`xdg-open`)	Explorer
VS Code	`code` or VS Code.app	`code`	VS Code

On Linux without a graphical session (SSH, containers) the window-opening buttons are disabled; the rest of DevOn keeps working.

Configuration

DevOn works without configuration. To change what is scanned, create ~/.devon/office.config.json:

{
  "scanRoots": ["~/Projects", "~/work"],
  "exclude": ["~/Projects/archive"]
}

Key	Meaning
`scanRoots`	Folders searched for projects. Replaces the defaults (`~/Projects`, `~/code`, `~/dev`, `~/src`, ...)
`exclude`	Extra path prefixes that never become rooms
`excludeExact`	Exact paths that never become rooms
`hidden`	Rooms hidden from the UI (managed by DevOn itself)

Environment variables:

Variable	Meaning
`OFFICE_PORT`	Port to listen on (default `4777`)
`CLAUDE_CONFIG_DIR`	Claude Code config folder, if it is not `~/.claude`
`DEVON_HOME`	Install folder (default `~/.devon`)

Privacy and security

The server binds to 127.0.0.1 and rejects requests from any other host or origin.
Prompts, tool input and tool output are never read or forwarded. Only the project and timestamp are read from history.
Nothing is written to disk except office.config.json, the log and the process id in ~/.devon.
Windows opened from DevOn do not inherit the tokens or environment of another Claude session.
There is no telemetry and no account.

Update and uninstall

Get the latest version:

devon update

Remove DevOn completely, including the hook:

devon uninstall

Troubleshooting

Problem	Fix
`devon: command not found`	Open a new terminal window. Or run it directly: `~/.devon/bin/devon`
The port is busy	Pick another one: `OFFICE_PORT=4800 devon` (PowerShell: `$env:OFFICE_PORT=4800; devon`)
It does not start	Read the log: `~/.devon/devon.log`
No rooms appear	Add your project folders to `scanRoots`, then `devon restart`
Claude Code runs inside WSL	Install DevOn inside WSL too, using the macOS / Linux command
Alpine or another musl Linux	Install Node.js 20+ from your package manager first, then run the installer

Release notes

Every version of DevOn, newest first. Get the latest with devon update; devon version shows what you have.

v0.2.02026-10-02

A more realistic look, like an architect's model: soft shadows, glass walls, calmer colours and separate materials for wood, metal, glass and asphalt.
People with real proportions and their own skin and hair tones, fuller trees, cars with wheels, kerbs and entrance canopies.
A brighter night: trees, lawns and streets stay visible in moonlight, and rooms with active sessions light their windows.
Cleaner labels in the scene.

v0.1.02026-10-02

First public release.
3D town of your Claude Code projects: rooms, buildings, lobby, streets.
Live mode: running sessions, tools in use, subagents and permission waits.
Morning and night themes; Uzbek, English and Russian.
One-command install for macOS, Linux and Windows, with automatic Node.js setup.
The devon command: start, stop, status, hooks, update, uninstall.
Room actions: open a Claude session, terminal, folder or VS Code in a project.

Enterprise

DevOn Enterprise, now in development, shows your whole company's Claude Code work on one live map, running entirely on your own servers.

100% on-premise: installed on your company's own servers. Nothing leaves your network.
Every employee is a country: the company is one map, and each employee's country holds their buildings and project rooms.
See what everyone is doing in Claude Code: the admin watches live who is working, on which project, and with which agents and tools.
Dashboards and reports: activity per person, team and project, by week and month, ready to export.
Early access: teams that contact us now get it first.

As in the free version, only metadata is collected: never prompts, code, tool input or tool output.

Interested in Enterprise for your team? Contact us: fill in the form and we will get back to you.

Feedback

Found a problem or have an idea? Write to us. Every message is read.