🌐 Website · GitHub

Desktop app that turns your AI agents into employees of a virtual isometric office

Every running AI agent (Claude Code, Gemini CLI, Codex CLI, ChatGPT, ...) appears as an animated character in a 2D isometric office. Install, open — see all your agents in real time. Zero changes to your CLI workflow required.

• Quick Start
• Basic Usage
• Concept
• App Tour
• How It Works
• Model Tiers
• Agent Lifecycle
• Idle Zones
• Agent Discovery
• Browser Extension
• IDE Support
• Troubleshooting
• Non-Goals
• Roadmap
• Commands
• Tech Stack
• Cross-Platform Support
• Documentation

• Node.js >= 22
• Rust >= 1.75
• System dependencies for Tauri v2

make install
make dev

The app opens in a native 1280x800 window. The Rust backend automatically starts scanning processes and logs.

1. Launch OfficeAI: Start the app using make dev or open the installed binary.
2. Run your AI Agent: Open a separate terminal and start your preferred agent (e.g., claude, gemini-cli, or codex).
3. Watch the Office: OfficeAI will automatically detect the new process. An employee character will appear, walk to their assigned desk, and begin reflecting the agent's real-time state (thinking, typing, or using tools).
4. Interact: Hover over agents to see their latest response or click the status bar to see a full list of active employees.

Each running AI agent is mapped to an animated office employee in a 2D isometric scene.

Key principles:

• 1 agent = 1 person — each AI agent process maps to a virtual employee
• Agent naming — {model name}-{PID}, e.g. claude-423235, gemini-23512, codex-54321, chatgpt-78901
• Open space — every agent has a personal desk
• Zero-intrusion — the app never modifies or wraps CLI agents
• Auto-discovery — the system detects running agents automatically

A quick walkthrough of what you see when you use OfficeAI.

Your AI agents, visualized as office employees. When you open OfficeAI, you see a full isometric office floor. Each running AI agent occupies its own desk. The status bar at the bottom shows the total agent count, and the settings button is in the top-left corner.

Bouncing balls mean the agent is busy. Colored balls appear above an agent's head when it is actively thinking, responding, or using tools. The ball color reflects the model tier — gold for expert models, blue for senior, and so on.

No balls — the agent is free. When an agent finishes its task, the balls disappear and the character leaves its desk to roam the office — visiting the water cooler, sofa, or kitchen. The process is still running, just waiting for your next prompt.

Speech bubbles show what agents are saying. Hover over a working agent to see a preview of its response right inside the office, without switching to your terminal or browser.

Cancellations are detected in real-time. If you interrupt an agent's task in your terminal (Ctrl+C), OfficeAI detects this state change instantly. The agent stops its current activity and returns to its idle routine.

Click the status bar to see all agents. The agents panel lists every detected agent along with its current status — Thinking, Using tool, Responding, Idle, and more. Use it to quickly check who is busy and who is available.

Sub-agents handle delegated work. Click the SUB-AGENTS tab to see background tasks that a main agent has spawned. This gives you visibility into parallel work happening behind the scenes.

The app icon shows the active agent count. A red badge on your dock or taskbar icon tells you how many agents are currently working. One glance is enough to know if something is running — no need to open the app.

General settings let you control core behavior. Open Settings from the top-left gear icon. The General tab includes scan interval, animation speed, max agents, and other global preferences.

Discovery settings configure how agents are found. The Discovery tab controls process scanning parameters and log file monitoring for each supported agent type.

Display settings customize the visual experience. The Display tab adjusts office layout, zoom level, speech bubble behavior, and other rendering preferences.

OfficeAI operates on a zero-intrusion principle — it only observes AI agents, never interferes with their work.

OS Processes (sysinfo)    Agent log files       Chrome Extension
        │                       │               (MV3 + Native Messaging)
        ▼                       ▼                       │
  Process Scanner (2s)  Log Watcher (500ms)    Extension HTTP Server
        │                       │               (localhost:7842)
        └──────────┬────────────┴───────────────────────┘
                   ▼
           Agent Registry ──► Tauri IPC Events
                   │
        ┌──────────┴──────────┐
        ▼                     ▼
   Svelte UI             PixiJS Renderer
   (overlay)             (isometric scene)

1. Process Scanner discovers CLI agents via OS process list
2. Log Watcher reads agent log files for status changes
3. Chrome Extension observes browser AI chats (ChatGPT, Gemini, Claude.ai) via DOM MutationObserver
4. State Classifier (FSM with debounce) determines agent state
5. Agent Registry maintains state, emits Tauri IPC events, and updates the app icon badge
6. Frontend renders agents as animated characters in an isometric office

The app icon badge displays the number of active agents directly on the dock (macOS) or taskbar (Linux), so you always know how many agents are working without switching to the app window.

Bug Report: If you encounter a bug, open Settings and click Bug Report to save a diagnostic JSON file. Attach it to a GitHub Issue — no data is sent automatically.

When the backend receives a model name from agent logs (e.g. "claude-opus-4-6"), it classifies it into one of four tiers:

Check order matters: Junior is checked first (so -mini catches o1-mini, o3-mini before Expert). Then Expert, Senior. Everything else — Middle.

When an agent is working (thinking, responding, tool_use), three animated bouncing balls appear above its sprite. The ball color is determined by model tier. Balls disappear when the agent finishes and transitions to idle.

Balls are positioned horizontally above the sprite head and animated with a staggered sine wave (bounce). Animation speed is controlled by the animationSpeed setting.

The visual state of an agent directly reflects its process status:

                    ┌─────────────────────────────────┐
                    │                                 │
                    ▼                                 │
┌──────┐    ┌──────────────┐    ┌──────────┐    ┌─────┴──────┐
│ Idle │───▶│ Walking      │───▶│ Thinking │───▶│ Responding │
│      │    │ to desk      │    │          │    │            │
└──┬───┘    └──────────────┘    └────┬─────┘    └─────┬──────┘
   │                                 │                │
   │                                 ▼                ▼
   │                           ┌──────────┐    ┌────────────┐
   │                           │ Tool Use │    │ Collabora- │
   │                           └────┬─────┘    │ tion       │
   │                                │          └─────┬──────┘
   │                                ▼                │
   │                          ┌───────────┐          │
   │◀─────────────────────────│ Task      │◀─────────┘
   │                          │ Complete  │
   │                          └───────────┘
   │
   │         ┌─────────┐    ┌──────────┐
   └────────▶│  Error  │    │ Offline  │
             └─────────┘    └──────────┘

When an agent has no active task, it randomly roams between rest areas in the office:

The system uses different detection strategies depending on the agent type:

OfficeAI includes a Chrome MV3 extension that tracks AI agent activity directly in browser tabs. It monitors ChatGPT, Gemini, and Claude.ai sessions in real time — each open chat appears as a separate employee in the office, just like CLI agents.

How it works:

• Content scripts use MutationObserver to detect DOM changes on AI chat pages (streaming responses, thinking indicators, tool use)
• The background Service Worker bridges content scripts to a Native Messaging Host (Node.js)
• The host forwards agent state via HTTP to the Tauri desktop app (localhost:7842)
• Each browser tab gets a unique agent ID: browser-{platform}-{hash} (e.g. browser-chatgpt-a1b2c3d4)

For full details — architecture, CSS selectors, detection algorithms, native messaging protocol — see EXTENSION.md.

OfficeAI natively supports Cursor and Windsurf — two popular AI-powered code editors. Their built-in AI assistants are detected automatically and appear as office employees, just like CLI agents.

How it works:

• The process scanner detects running Cursor/Windsurf processes via OS process list. GUI apps bypass the TTY filter since they don't have a terminal attached.
• The log watcher monitors IDE-specific directories for file activity changes (mtime polling).
• Since IDE agents cannot signal task completion explicitly, a 15-second inactivity timeout is used — if no file changes are detected within 15s, the agent transitions to idle.
• Each Cursor session gets a unique agent ID: log-cursor--{session-hash}. Windsurf uses a fixed ID: log-windsurf--activity.

Setup: No configuration needed — just launch Cursor or Windsurf and start using their AI features. OfficeAI will detect them automatically.

• Agent not appearing? Verify the log root in Settings > Discovery. For example, Claude Code logs are usually in ~/.claude/projects/.
• Process not detected? Some agents run via node or python. Ensure your agent_process_patterns in settings include the correct regex for your environment.
• Diagnostic Log: If you run into issues, go to Settings > General and click Bug Report. This generates a diagnostic.json file for debugging.

• The app never modifies CLI agent behavior, injects middleware, or requires config changes.
• No network requests to external servers — all processing is local.
• This is not a CLI replacement — the visualizer is a companion/monitor tool only.
• Prompt data is never stored or transmitted — only metadata is used (state, model name, token counts).

• ChatGPT CLI Support — integration with official and community-built CLIs.
• Browser Model Tracking — ChatGPT, Gemini, Claude.ai web sessions tracked via Chrome MV3 extension.
• Office Customization — changeable floor plans, custom furniture, and skins.
• Collaboration Mode — visual links/indicators when multiple agents are delegating tasks to each other.
• New Idle Zones — gym area, library, and outdoor garden for more character variety.

The app icon badge shows the number of currently active agents (not idle, not offline) as a numeric indicator on the dock/taskbar icon. When no agents are active, the badge is removed. The badge updates automatically on every agent state change — registration, status transition, and removal.