← Toolsjui viz: watch your agents work`jui viz` shows the Claude Code sessions and subagents running on your machine (the Codex sessions too) as rooms and robots in the browser. Start with the demo below, then pick the article for what you want to do.3 min read
This is the demo, running in your browser with made-up data. It talks to no server. Its words are in English; the Japanese version of this page shows the Japanese screen. Drag to rotate, scroll to zoom, and tap a board or a robot for details.
What it showsEach project folder gets a room, and each session gets a robot with a headband at a desk.A robot shows what it is doing now — reading a file, writing one, running a command, running a test, waiting for permission — with a motion and one line of text.In a JsonUI project, the same screen also shows how far each spec has got, the tasks, the test runs and the permission requests. You can answer a permission request from the browser.
It stays on your machineThe page runs only on your machine. The server listens on `127.0.0.1` only.It makes only these outside connections:
• the daily fetch of public cloud price lists (on by default; `jui viz cloud-prices off` stops it)
• the near weather, only when you turn it on
• the Slack intake, only once you write slack.json: Slack itself, the router you choose, and with mode connector Claude. See the Slack intake article for what goes where.
Which article to readNew to jui viz? Start with Set up. The other articles each cover one part of the screen, so read them in any order.
Set upInstall the plugin, start the server, change the page's language, and update, remove or troubleshoot jui viz./viz/setup
Codex sessionsCodex sessions in the same rooms, their permission requests on the page, starting one from the bell, and local models from LM Studio or Ollama. Also prompts from the card, the History tab and Clock out./viz/codex
The room and its robotsWhat a room, a robot, its motion and its one line of text tell you about a session./viz/room
Skill spiritsThe spirits that appear when a session uses a skill, and how to bring in 3D models of your own./viz/spirits
Panels, cards and boardsThe side panel, a robot's card and the boards that list specs and tasks./viz/panels
Talk, prompts and notificationsReading the messages sessions send each other, sending a session a prompt from the page, and getting browser notifications./viz/sessions
Messages between sessions`jui viz message` sends a message from one session to another, Claude Code and Codex alike, and both robots' Talk shows it./viz/messages
Slack intakeFetch Slack messages (also as they are written, through Socket Mode), mask secrets on your machine, sort them into projects, and turn them into tasks on a whiteboard that you send to a running session./viz/slack
Slack setupMake the Slack app, choose its scopes, take the tokens, turn on Socket Mode, write slack.json, start the robot, and read the room's errors./viz/slack-setup
Permissions and questionsAnswering Claude Code's permission requests and questions from the browser instead of the terminal./viz/approvals
Watching testsSeeing a JsonUI test run on iOS, Android or the web, and reading whether it passed./viz/tests
Server roomThe room's server room, which shows the infrastructure your project declares in 3D, or flat in 2D./viz/server-room
Infra modelThe files that describe your infrastructure, which the server room reads./viz/infra-model
Cost and migrationEstimating what the infrastructure costs a month, and planning a migration./viz/cost
Keep reading
Set upInstall the plugin, start the server, change the page's language, and update, remove or troubleshoot jui viz./viz/setup