Claude Office plugin
A pixel-art office on screen shows Claude Code agents at work: who is busy, who awaits approval and what each session costs.
- 359 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The script edits `~/.claude/settings.json`, adding hooks and a status line.
- The Allow button in the office confirms Claude Code permission prompts.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/claude-officeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The script edits `~/.claude/settings.json`, adding hooks and a status line.
- The Allow button in the office confirms Claude Code permission prompts.
This is third-party code. Review the repository files before installing.
What it does
Claude Office draws an isometric pixel-art office where Claude Code agents sit at desks, take breaks and chat. Claude Code hooks and the status line send every agent spawn, tool call, prompt and permission wait to a local server, which passes events to the frontend over WebSocket. Each session gets its own pill and its own Claude at a desk. A permission prompt raises a character’s hand with a chime, and the Allow button sits right in the office. Clicking a character opens a card: task, tools called, tokens and model. The whiteboard shows the real task list, and cost, tokens per minute and context fill are metered per session. A failed deploy turns the office red.
Who it is for. Developers who run several Claude Code sessions and subagents and want their state on one screen.
Good fit when
- Subagents work in parallel and it is unclear which one waits for approval.
- Cost and context fill per session are wanted in one view.
- Permission for `git push` is easier to grant with a button from the office window.
- Colleagues or a screen recording need a demo of agents at work.
Not a fit when
- Precise observability with stored metrics is needed.
- The environment cannot run a local server on port 3334.
- The hooks in `~/.claude/settings.json` must not be changed.
Example request
Start the office and show which of my sessions wait for approval and how many tokens per minute each one burns.Limitations
The `npm run install-hooks` script adds hooks and a status line to `~/.claude/settings.json`, so save a copy first. The server listens on `127.0.0.1` only, and the phone mode over the network is enabled by a separate `npm run lan` command. Events, permission answers and chat wiping need the token from `~/.agent-office/auth-token`. Windows works through WSL or Git Bash. The Dunder Mifflin mode uses characters from the TV series as fan art.
How to disable. Run `npm run uninstall-hooks` or `npx @w17ant/agent-office uninstall-hooks`, then stop the server with `bash scripts/stop-office.sh`.
FAQ
How do I connect Claude Office to Claude Code?
Run `npm install`, then `npm run install-hooks`: the script adds hooks and a status line to `~/.claude/settings.json`. Then start `bash scripts/start-office.sh`.
Is there a no-checkout option?
Yes, after the npm release: `npx @w17ant/agent-office install-hooks` once, then `npx @w17ant/agent-office`. Node 22 or newer is needed.
What if nobody shows up in the office?
Run `npm run doctor`: the command checks the whole setup and names what is missing.
Is the office visible from the network?
Not by default: the server listens on `127.0.0.1` only. Phone mode is enabled with `npm run lan` and gives watch-only access.
Is there a desktop app?
Yes, installers for Mac, Windows and Linux are in Releases. The app updates itself and adds a tray icon.
Discussion
No questions or reviews yet.
Related
PluginsA ready-made Claude Code setup: agents, slash commands, skills, safety hooks, rules and MCP connections in one install
Streams Claude Code hidden thinking, tool calls and subagents to a separate terminal with a live session tree
Three Claude Code plugins: the savvy-flow orchestrator with tiered subagents and two mods for a progress panel and a cache timer
Claude Code kit with eight phase agents, 21 skills and hooks that keep the agent inside set limits.
A Claude Code mod that draws a live map of the work beside the chat: tool calls, hooks, skills and subagents show up at once.
Cubicle Crew draws Claude Code, Codex, Gemini CLI and OpenCode sessions as a pixel-art office: who is busy, waiting or done.
README in short
The project connects to Claude Code through hooks and the status line. It starts from a clone or through `npx`, and a desktop app on Electron exists. Details on events, settings and the security model are in `docs/reference.md`.