Sometimes I wonder what Claude is actually doing when it works. When you give it a task, it sends out a stream of messages like "reading this file", "running this command", "writing new code". But it's just text flying by.
So I built this. An app that captures those messages and turns them into something visual. Imagine looking into a glass office building where you can see everyone working. Every time Claude uses a tool, a new "agent" appears on screen. It's like a reality show from an office. You see who's doing what, who's talking to whom, and when things get done.
In short:
- You give Claude a task
- Claude sends out live updates
- The app catches them and draws agents in a virtual office
- Manager: The boss keeping track of everything
- Developers: Running bash commands and building stuff
- Researchers: Digging through files and searching for info
- Writers: Writing new code from scratch
- Editors: Fixing and improving existing code
They talk to each other, pick up new skills, and deliver work. All in real time.
Make sure you have installed:
- Node.js (v18 or newer): nodejs.org
- Claude Code CLI: docs.anthropic.com
Check that everything is installed:
node --version # Should show v18.x.x or higher
claude --version # Should show Claude Code versionCopy the entire claude-office-viz folder to your preferred location:
cp -r claude-office-viz ~/claude-office-viz
cd ~/claude-office-vizRun these commands:
# Install server dependencies
cd server
npm install
# Install client dependencies
cd ../client
npm installYou need 3 terminal windows:
cd ~/claude-office-viz/server
node bridge.jsYou'll see:
Claude Office Bridge started on port 3001
Waiting for WebSocket connections...
cd ~/claude-office-viz/client
npm run devOpen your browser at: http://localhost:3000
claude --output-format stream-json | node ~/claude-office-viz/server/bridge.jsOr just test with demo mode: If you don't pipe Claude Code output, bridge.js will automatically start demo mode after 3 seconds.
- Just start bridge.js without piping anything to it
- Open the visualization in your browser
- After 3 seconds, demo mode starts automatically
- Start bridge and visualization as described above
- In a new window, run Claude Code with JSON output:
claude --output-format stream-json "write a simple python script" 2>&1 | node ~/claude-office-viz/server/bridge.js- Watch the agents work in real time in your browser!
┌─────────────────┐ JSON stream ┌──────────────────┐
│ Claude Code │ ──────────────────▶ │ bridge.js │
│ (CLI) │ │ (Node.js) │
└─────────────────┘ └────────┬─────────┘
│ WebSocket
▼
┌──────────────────┐
│ React App │
│ (Browser) │
└──────────────────┘
| Component | Port | Description |
|---|---|---|
| bridge.js | 3001 | WebSocket server that parses Claude Code output |
| React App | 3000 | Office visualization |
Bridge.js sends these events to the client:
| Event | Description |
|---|---|
agent_joined |
New agent has joined the office |
agent_updated |
Agent has changed status/task |
work_completed |
Agent has completed a task |
communication |
Communication between agents |
new_task |
New task received from user |
In bridge.js, edit the AGENT_COLORS array:
const AGENT_COLORS = [
'#FF6B6B', // Red
'#4ECDC4', // Teal
'#45B7D1', // Blue
// Add more...
];In bridge.js, extend the getAgentRole() function:
function getAgentRole(toolName) {
const roles = {
'bash': 'developer',
'MyCustomTool': 'specialist', // Add new
// ...
};
return roles[toolName] || 'worker';
}Edit client/src/App.jsx to:
- Change layout and positioning
- Add new animations
- Change agent avatars and icons
- Check that bridge.js is running
- Check that port 3001 isn't blocked by firewall
- Try refreshing the browser
- Wait 3 seconds for demo mode
- Or run Claude Code with
--output-format stream-json
Make sure you have the right version of Claude Code:
claude --help | grep output-formatclaude-office-viz/
├── server/
│ ├── package.json
│ └── bridge.js # WebSocket bridge
├── client/
│ ├── package.json
│ ├── vite.config.js
│ ├── index.html
│ └── src/
│ ├── main.jsx
│ └── App.jsx # React visualization
├── start.sh # Convenience script
└── README.md
MIT. Do whatever you want with it!
Follow me for more sideways looks at the AI world: LinkedIn
Made with ❤️ and Claude