paulrobello/claude-office

What is it?

Key features

• 01Animated office where the main agent and subagents are shown as boss and employee characters
• 02Command Center overview of all live Claude Code sessions with status columns
• 03Multi-floor building view with per-floor offices and session switching
• 0412-mode whiteboard including todo list, tool usage chart, and kanban
• 05Context window tracking shown as a trashcan that fills as context grows
• 06OpenCode plugin support and Docker deployment

Use cases

• Keeping an at-a-glance view of several Claude Code terminals that need attention or are still working
• Watching how a main agent delegates work to subagents during a complex coding task
• Demonstrating or teaching agent workflows with a visual, animated interface
• Running the visualizer as a shared Docker service fed by hooks from local tools

Quick start

1. 1

   Clone the repository

   git clone https://github.com/paulrobello/claude-office.git
2. 2

   Enter the project directory

   cd claude-office
3. 3

   Install all components (backend, frontend, hooks)

   make install-all
4. 4

   Start the development servers in tmux, then open http://localhost:3000

   make dev-tmux

Things to know

• !Requires Python 3.13+, Node.js 20+, uv, and a Claude Code CLI or OpenCode setup.
• !AI-powered name and task summaries need a Claude Code OAuth token; without it, raw agent IDs are shown.

In collections

Topics

FAQ

What is claude-office?

Real-time pixel art office that animates Claude Code sessions, showing the main agent as a boss and subagents as employees. Claude Office Visualizer turns Claude Code activity into an animated pixel art office. The main Claude agent appears as a "boss" character that delegates work, and each subagent appears as an "employee" moving around the office as it runs tasks. Hooks installed into Claude Code send lifecycle events to a FastAPI backend, which pushes state over WebSocket to a Next.js and PixiJS frontend.

Is claude-office free to use? What license does it have?

claude-office is open source under the MIT license. Check the license terms before using it in commercial products.

Is claude-office still maintained?

Actively maintained. The last commit to claude-office was on Nov 5, 2026.

What can I use claude-office for?

Keeping an at-a-glance view of several Claude Code terminals that need attention or are still working Watching how a main agent delegates work to subagents during a complex coding task Demonstrating or teaching agent workflows with a visual, animated interface Running the visualizer as a shared Docker service fed by hooks from local tools

How do I install claude-office?

Clone the repository: git clone https://github.com/paulrobello/claude-office.git Enter the project directory: cd claude-office Install all components (backend, frontend, hooks): make install-all Start the development servers in tmux, then open http://localhost:3000: make dev-tmux

Where can I get claude-office?

The source code and installation instructions are on GitHub: https://github.com/paulrobello/claude-office