Skip to content
Back to search

Claude-Office

SkillWorks with Claude CodeGitHub

A pixel art virtual office that visualizes your AI agents working in real-time. Claude Code hooks, WebSocket events, and isometric pixel art.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/W17ant/Claude-Office with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/W17ant/Claude-Office'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/w17ant--claude-office/badge.svg)](/listings/w17ant--claude-office)

HTML

<a href="/listings/w17ant--claude-office"><img src="/api/listings/w17ant--claude-office/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Clone
git clone https://github.com/W17ant/Claude-Office.git
cd Claude-Office

# Install
npm install

# Connect Claude Code (adds the hooks + status line to ~/.claude/settings.json, safe to re-run)
npm run install-hooks

# Start everything (server + frontend + chat watcher) and open the office
bash scripts/start-office.sh

# Stop everything
bash scripts/stop-office.sh

Now spawn agents in Claude Code and watch them appear in the office.

- **Rather have an app?** Grab the installer for Mac, Windows or Linux from [Releases](https://github.com/W17ant/Claude-Office/releases). - **Nothing showing up?** `npm run doctor` checks the whole setup and tells you what's missing. - **Want it gone?** `npm run uninstall-hooks` takes the hooks back out. - Works on macOS and Linux, and on Windows through WSL or Git Bash.

Installing it as a Claude Code plugin, the hook events, every setting and the security model are all in the [reference](docs/reference.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "agent-office",
  3. "description": "Claude Office: the pixel-art office that visualises Claude Code agents. This repository is its own marketplace; the plugin is the repository root.",
  4. "owner": {
  5. "name": "W17ant",
  6. "url": "https://github.com/W17ant"
  7. },
  8. "plugins": [
  9. {
  10. "name": "agent-office",
  11. "source": "./",
  12. "description": "Hooks that forward subagent, MCP and session activity to the Agent Office server, plus the /agent-office:office command.",
  13. "category": "productivity",
  14. "tags": ["hooks", "agents", "visualization"]
  15. }
  16. ]
  17. }
README.md · README · 431 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Claude Office
  2. [![npm](https://img.shields.io/npm/v/@w17ant/agent-office)](https://www.npmjs.com/package/@w17ant/agent-office) [![npm downloads](https://img.shields.io/npm/dm/@w17ant/agent-office)](https://www.npmjs.com/package/@w17ant/agent-office) [![Latest release](https://img.shields.io/github/v/release/W17ant/Claude-Office)](https://github.com/W17ant/Claude-Office/releases/latest) [![GitHub stars](https://img.shields.io/github/stars/W17ant/Claude-Office?style=social)](https://github.com/W17ant/Claude-Office)
  3. A pixel art virtual office that visualizes your AI agents working in real-time. Watch Claude Code agents spawn, sit at desks, take coffee breaks, and chat in a Slack-inspired office chat panel — all rendered in an isometric pixel art office.
  4. ## Update — rooms, seasons and a quieter office
  5. **What's new**
  6. - **Four more rooms** — a corridor, a meeting room, a server room and a lunch room. Click a door in the picture (or the floor plan in the corner) and the stage goes there; your boss walks over through the corridor
  7. - **The office follows the calendar** — spring, summer, autumn and winter all year round, with Christmas, Halloween, Easter and Valentine's Day on top: decorated rooms, desks and plants in both themes
  8. - **Halloween costumes** — Claude is a vampire and the boss a wizard; in Dunder Mifflin mode Michael, Dwight, Jim and Pam dress up and everyone else wears a mask or a witch hat
  9. - **The boss shouts the prompt** from where he stands instead of walking it over; the Claude it's for gets a "!"
  10. - **Prompts from the chat** — type `@agent-office fix the failing test` in the office chat and that session picks it up when its turn ends
  11. - **A quieter soundtrack** — a soft ambient office instead of bleeps, with gentle cues for a prompt sent, a reply in and Claude needing you (turn the ambience off in Settings)
  12. - **Your phone** — `npm run lan` prints a QR code; taps on the phone (water a plant, ring the bell) play on the desktop too
  13. - The full list is in the [CHANGELOG](CHANGELOG.md)
  14. ### Click a door — the boss follows you
  15. ![Clicking the office door shows the corridor, then the meeting room door; the boss walks through the corridor and arrives in the meeting room](docs/images/rooms.gif)
  16. ![The corridor with its five doors, the meeting room, the server room with its racks, and the lunch room](docs/images/rooms.png)
  17. ### Every season
  18. ![The office at Christmas, Halloween, Easter, Valentine's Day, and in spring, summer, autumn and winter](docs/images/seasons.png)
  19. ### Halloween in Dunder Mifflin mode
  20. ![The Scranton office decorated for Halloween, staff walking about in masks and a witch hat](docs/images/halloween-dunder-mifflin.gif)
  21. ### Click the furniture
  22. ![Clicking the coffee machine: the boss walks over and comes away with a coffee](docs/images/coffee-errand.gif)
  23. ## Update — 1.1: the level-up
  24. > We had 12 hours and 90 % of our 20x plan still to use 😂 so I asked Claude to level up Claude Office (using Fable 5.1 <img src="docs/images/claude-crab.gif" height="36" alt="" align="absmiddle"> and <img src="docs/images/ultracode.svg" height="20" alt="ultracode" align="absmiddle">).
  25. **What's new**
  26. - **A Claude for every terminal** — each Claude Code session gets its own pill, model badge and Claude at a desk
  27. - **Claude acts out the turn** — the boss shouts your prompt across the office, Claude types, naps when it's done
  28. - **✋ Needs you** — a permission prompt raises Claude's hand with a chime, and you can click **Allow** right in the office
  29. - **Click anyone** — an inspector card shows what they're doing, every tool they've called and what they've said
  30. - **Prod Is Down** — a failed deploy turns the office red; a 🚀 for deploys, a 🎉 for pushes to main, ❌ for failing tests
  31. - **The whiteboard is real** — it shows Claude's actual task list
  32. - **Payroll, electricity and memory meters** — cost, tokens per minute and context fill per session
  33. - **Desktop app** with a tray badge and a mini widget, installers for Mac, Windows and Linux
  34. - Plus three bug hunts, a security pass and 972 tests — the full list is in the [CHANGELOG](CHANGELOG.md)
  35. ### Claude's turn, start to nap
  36. ![The boss shouts the prompt from his desk, Claude gets a '!' and starts typing, a worker comes in to help and leaves, then Claude replies](docs/images/claudes-turn.gif)
  37. ### Click a character
  38. ![Inspector card: the task, tools used with a failed call in red, tokens and model, and the end of the agent's own transcript](docs/images/inspector.png)
  39. ### ✋ Needs you — answer it from the office
  40. ![Claude's hand is up, the session pill is amber, and a card asks to run git push origin main with Allow, Allow & remember and Deny](docs/images/permission-card.png)
  41. ### Prod Is Down — and back again
  42. ![A deploy fails and the office turns red with a spinning beacon and an incident timer, then the fix lands and the lights come back with a postmortem](docs/images/prod-is-down.gif)
  43. ### The whiteboard is your real task list
  44. ![Post-its land in To do, move through In progress to Done, with a red pin on a blocked task](docs/images/task-board.gif)
  45. ### Payroll, electricity and memory
  46. ![Office meters: cost, tokens per minute and context fill per session, with the 5h rate-limit pill](docs/images/meters.png)
  47. ## Update — Dunder Mifflin mode
  48. Type `/the-office` in the Slack chat panel to flip the whole office into a Scranton-branch tribute. The room, the cast, and the chatter all swap over — Michael Scott runs the place, Jim is your assistant, and Dwight guards the beet cellar. (Fan art — see [NOTICE.md](NOTICE.md).)
  49. ### Pretzel day, every day
  50. <p>
  51. <img src="docs/images/dunder-mifflin-day.png" alt="Dunder Mifflin — Day" width="48%">
  52. <img src="docs/images/dunder-mifflin-night.png" alt="Dunder Mifflin — Night" width="48%">
  53. </p>
  54. **What changes when you toggle it on**
  55. - 27 cast members (Michael, Jim, Pam, Dwight, Kevin, Angela, Stanley, Creed, David Wallace, Bob Vance — the whole office) dealt to agent roles
  56. - Role chatter swaps to in-character lines (`"Bears. Beets. Battlestar Galactica."`, `"selling paper"`, `"Schrute bucks awarded"`)
  57. - Michael occasionally lands his signature `"That's what she said 😏"` when replying to finished work
  58. - Character prop overlays — Michael rotates World's Best Boss mug / Dundie / Golden Ticket / Prison Mike bandana / "NO GOD PLEASE NO", Dwight gets the CPR dummy mask or a Schrute Buck, Jim keeps his jello stapler, Stanley gets a pretzel, Jan gets a Serenity by Jan candle, Oscar / Pam / Toby share the Finer Things Club
  59. - Angela gets a follower cat *and* a head-cat (randomized from 12 cat sprites)
  60. - Kevin's chili, pretzel day, and Finer Things Club references sprinkled through the break-room chatter
  61. ### The cast
  62. <p align="center">
  63. <img src="docs/images/michael-scott.png" alt="Michael Scott" height="140">
  64. <img src="docs/images/jim-halpert.png" alt="Jim Halpert" height="140">
  65. <img src="docs/images/pam-beesly.png" alt="Pam Beesly" height="140">
  66. <img src="docs/images/dwight-schrute.png" alt="Dwight Schrute" height="140">
  67. <img src="docs/images/angela-martin.png" alt="Angela Martin" height="140">
  68. <img src="docs/images/kevin-malone.png" alt="Kevin Malone" height="140">
  69. <img src="docs/images/stanley-hudson.png" alt="Stanley Hudson" height="140">
  70. <img src="docs/images/andy-bernard.png" alt="Andy Bernard" height="140">
  71. <img src="docs/images/kelly-kapoor.png" alt="Kelly Kapoor" height="140">
  72. <img src="docs/images/ryan-howard.png" alt="Ryan Howard" height="140">
  73. <img src="docs/images/creed-bratton.png" alt="Creed Bratton" height="140">
  74. <img src="docs/images/robert-california.png" alt="Robert California" height="140">
  75. <img src="docs/images/david-wallace.png" alt="David Wallace" height="140">
  76. <img src="docs/images/bob-vance.png" alt="Bob Vance, Vance Refrigeration" height="140">
  77. </p>
  78. ### Easter-egg props
  79. Each cast member gets a signature prop floating above their desk in place of the usual coffee/energy-drink bubble.
  80. <p align="center">
  81. <img src="docs/images/prop-worlds-best-boss.png" alt="World's Best Boss mug (Michael)" height="70">
  82. &nbsp;&nbsp;
  83. <img src="docs/images/prop-dundie.png" alt="Dundie Award (Michael)" height="70">
  84. &nbsp;&nbsp;
  85. <img src="docs/images/prop-golden-ticket.png" alt="Golden Ticket (Michael)" height="70">
  86. &nbsp;&nbsp;
  87. <img src="docs/images/prop-prison-mike.png" alt="Prison Mike bandana (Michael)" height="70">
  88. &nbsp;&nbsp;
  89. <img src="docs/images/prop-no-god.png" alt="NO GOD PLEASE NO (Michael)" height="70">
  90. &nbsp;&nbsp;
  91. <img src="docs/images/prop-cpr-mask.png" alt="CPR Dummy Mask (Dwight)" height="70">
  92. &nbsp;&nbsp;
  93. <img src="docs/images/prop-schrute-buck.png" alt="Schrute Buck (Dwight)" height="70">
  94. &nbsp;&nbsp;
  95. <img src="docs/images/prop-jello-stapler.png" alt="Jello Stapler (Jim)" height="70">
  96. &nbsp;&nbsp;
  97. <img src="docs/images/prop-pretzel.png" alt="Pretzel Day (Stanley)" height="70">
  98. &nbsp;&nbsp;
  99. <img src="docs/images/prop-serenity-candle.png" alt="Serenity by Jan (Jan)" height="70">
  100. &nbsp;&nbsp;
  101. <img src="docs/images/prop-finer-things.png" alt="Finer Things Club (Oscar / Pam / Toby)" height="70">
  102. &nbsp;&nbsp;
  103. <img src="docs/images/prop-paper-box.png" alt="Dunder Mifflin Paper Box" height="70">
  104. &nbsp;&nbsp;
  105. <img src="docs/images/prop-dunder-logo.png" alt="Dunder Mifflin Logo" height="70">
  106. &nbsp;&nbsp;
  107. <img src="docs/images/prop-angela-cat.png" alt="Angela's cat" height="70">
  108. </p>
  109. Toggle it off any time with `/the-office` again — state persists in `localStorage`.
  110. ---
  111. ### Full office — agents working, chatting, and taking coffee breaks
  112. ![Day Mode](docs/images/Day-Mode.png)
  113. ## Features
  114. **Live Agent Visualization**
  115. - Agents appear as pixel art characters that walk into the office through the door
  116. - Each agent type gets a unique character sprite and desk assignment
  117. - Agents show typing bubbles, take coffee/water breaks, and leave when done
  118. - One pill per Claude Code session, each with its own Claude at a desk
  119. - Boss character (you) with an energy drink, Claude with coffee
  120. - Random office events: pizza deliveries, fire drills, power flickers, printer jams
  121. - In your language: English, Español, Português (Brasil), Français, Deutsch, Italiano, 日本語, 한국어, 简体中文, 繁體中文, Bahasa Indonesia, Русский and Türkçe (Settings › Language). Every language but English is a draft, marked *work in progress*: fixes welcome, see [CONTRIBUTING › Add or fix a language](CONTRIBUTING.md#add-or-fix-a-language)
  122. - Day/night cycle with smooth transitions
  123. - Seasons: the office follows the calendar, spring, summer, autumn and winter all year round with Christmas, Halloween, Easter and Valentine's Day on top, every one drawn in both themes — see [Seasons](docs/reference.md#seasons)
  124. - **Settings** (the ⚙ in the title bar): theme, day/night, season, sound and the server settings in one panel — see [Settings](docs/reference.md#settings-panel)
  125. - **Today** (bottom-right of the status strip): the day's sessions, agents, tasks, deploys, failures, incidents and payroll, kept across restarts — or `/recap` in the chat
  126. - **More rooms**: a corridor, a meeting room, a server room and a lunch room; click a door or the floor plan to go there and the boss follows — see [Rooms](docs/reference.md#rooms)
  127. **AI-Powered Office Chat**
  128. - Back-and-forth conversation with Claude through the office chat panel
  129. - Claude has a witty office manager personality with running jokes
  130. - Multi-agent routing — mention a bug and the Debugger responds, ask about UI and Frontend answers
  131. - Typing indicators, emoji reactions, read receipts
  132. - Slash commands: `/status`, `/agents`, `/recap`, `/incident`, `/all-clear`, `/help`
  133. - Chat history persists across restarts (SQLite)
  134. - Proactive messages — agents announce when they start and finish work
  135. - Desktop notifications for important events
  136. **Context-Aware AI**
  137. - Claude knows your current git branch and active agents
  138. - Conversation memory — remembers the last 10 messages
  139. - AI On/Off toggle to control token usage
  140. ### Night mode — the office after dark, agents still grinding
  141. ![Night Mode](docs/images/night-mode.png)
  142. ### Waiting for tokens... the office keeps itself entertained
  143. ![Waiting for tokens](docs/images/entertainment-waiting-tokenreset.png)
  144. ## How It Works
  145. Claude Code hooks and its status line send every agent spawn, tool call, prompt and permission wait to a local Express + WebSocket server, which broadcasts them to the React frontend.
  146. ```
  147. Claude Code ──hooks + status line──> Express Server ──WebSocket──> React Frontend
  148. │
  149. SQLite (chat)
  150. │
  151. Chat AI Watcher ──claude -p──> Reply
  152. ```
  153. ## Quick Start
  154. ```bash
  155. # Clone
  156. git clone https://github.com/W17ant/Claude-Office.git
  157. cd Claude-Office
  158. # Install
  159. npm install
  160. # Connect Claude Code (adds the hooks + status line to ~/.claude/settings.json, safe to re-run)
  161. npm run install-hooks
  162. # Start everything (server + frontend + chat watcher) and open the office
  163. bash scripts/start-office.sh
  164. # Stop everything
  165. bash scripts/stop-office.sh
  166. ```
  167. Now spawn agents in Claude Code and watch them appear in the office.
  168. **No checkout** (Node 22+):
  169. ```bash
  170. npx @w17ant/agent-office install-hooks # connect Claude Code (once)
  171. npx @w17ant/agent-office # start the office and open it; Ctrl+C stops it
  172. ```
  173. `doctor`, `stop`, `uninstall-hooks` and `--detach` work the same way; see [Run it with npx](docs/reference.md#run-it-with-npx).
  174. - **Rather have an app?** Grab the installer for Mac, Windows or Linux from [Releases](https://github.com/W17ant/Claude-Office/releases).
  175. - **Nothing showing up?** `npm run doctor` checks the whole setup and tells you what's missing.
  176. - **Want it gone?** `npm run uninstall-hooks` takes the hooks back out.
  177. - Works on macOS and Linux, and on Windows through WSL or Git Bash.
  178. Installing it as a Claude Code plugin, the hook events, every setting and the security model are all in the [reference](docs/reference.md).
  179. ## Other AI tools
  180. The office can show sessions from other AI coding tools too, tagged with the tool's name on the session strip. Connect one with `--tool`:
  181. | Tool | Connect it | Status |
  182. |---|---|---|
  183. | Codex | `npm run install-hooks -- --tool codex`, then type `/hooks` in Codex once to approve it | experimental — tell us if it works ([#115](https://github.com/W17ant/Claude-Office/issues/115)) |
  184. | Gemini CLI | `npm run install-hooks -- --tool gemini` | experimental — tell us if it works ([#115](https://github.com/W17ant/Claude-Office/issues/115)) |
  185. | OpenCode | `npm run install-hooks -- --tool opencode` | experimental — tell us if it works ([#115](https://github.com/W17ant/Claude-Office/issues/115)) |
  186. | Antigravity | `npm run install-hooks -- --tool antigravity` | experimental — tell us if it works ([#115](https://github.com/W17ant/Claude-Office/issues/115)) |
  187. | Kimi | `npm run install-hooks -- --tool kimi` | experimental — tell us if it works ([#115](https://github.com/W17ant/Claude-Office/issues/115)) |
  188. With npx it is `npx @w17ant/agent-office install-hooks --tool <id>`. `uninstall-hooks --tool <id>` takes out only what it added. Nothing leaves your machine: the hook only talks to the office on `127.0.0.1`. How it works, and how to add a tool: [reference › Other AI tools](docs/reference.md#other-ai-tools).
  189. ## Customise Your Character
  190. The boss character (you) is configurable via `office.config.json`:
  191. ```json
  192. {
  193. "boss": {
  194. "name": "YourName",
  195. "sprite": "MyChar-1",
  196. "color": "#ff4444",
  197. "emoji": "crown"
  198. }
  199. }
  200. ```
  201. Change it and reload the page — no rebuild needed.
  202. ### Creating a custom sprite
  203. Use the Helper sprite sheet as a reference for the 4-direction layout — here's an example of mine next to it:
  204. <p>
  205. <img src="docs/images/Helper.png" alt="Helper Sprite Template" height="250">
  206. <img src="docs/images/Me-1-front-right.png" alt="Custom Boss — Front Right" height="250">
  207. <img src="docs/images/Me-1-rear-left.png" alt="Custom Boss — Rear Left" height="250">
  208. </p>
  209. Here's Mini Claude — I asked Claude to describe itself after showing it the office with my avatar, then used the prompt to generate the sprite:
  210. <img src="docs/images/mini-claude.png" alt="Mini Claude" height="500">
  211. 1. Open ChatGPT (with DALL-E image generation)
  212. 2. Upload `public/sprites/characters/Helper.png` as a reference
  213. 3. Ask it to generate a pixel art character in the same style and layout (4 directions: front-left, rear-right, front-right, rear-left)
  214. 4. Save the output and extract the sprites:
  215. ```bash
  216. python3 scripts/extract-boss-sprite.py your-character.png MyChar-1
  217. ```
  218. #### Make it walk
  219. The cast walk with a four-frame cycle (left foot down, passing, right foot down, passing) instead of gliding. A custom sprite glides until it has one; one more ChatGPT image gives it the whole cycle. Walking uses three directions, so the image is a 3 × 4 grid: a row per direction, a column per step.
  220. 1. Make the image to upload: the three standing poses side by side on magenta. The script also prints the prompt to use:
  221. ```bash
  222. python3 scripts/walk-cycle.py prepare MyChar-1
  223. ```
  224. 2. In ChatGPT, upload `MyChar-1-walk-input.png` with that prompt and save the sheet it draws. Check it before cutting: 3 rows of 4, every figure facing the same way as its standing pose, the bottom row showing the back of the head (not the face), and the same clothes in every frame. If one is off, ask again; a new image costs nothing on a ChatGPT plan.
  225. 3. Cut it into the 12 frames (`MyChar-1-front-left-walk1.webp` … `MyChar-1-rear-left-walk4.webp`, beside the sprites):
  226. ```bash
  227. python3 scripts/walk-cycle.py cut your-walk-sheet.png MyChar-1
  228. ```
  229. Reload the office and your character walks. The script places each frame on the standing sprite's canvas with its feet where the standing pose's feet are, and mirrors a row ChatGPT drew facing the wrong way. Add `--no-mirror` if the outfit has words on it, so they never read backwards. It needs Pillow and numpy (`pip3 install Pillow numpy`).
  230. For the Christmas look, do the same with `--festive` on both commands once your `-xmas.webp` copies exist (see [Christmas](docs/reference.md#christmas)). Your character then keeps its festive outfit mid-step. Any other season's outfit works the same way with `--season NAME` (`--season autumn` reads the `-autumn.webp` copies; `--festive` is short for `--season christmas`), see [Seasons](docs/reference.md#seasons).
  231. <details>
  232. <summary>The walk-cycle prompt</summary>
  233. > This is a pixel-art game character standing in 3 directions (left figure, middle figure, right figure). Make a 4-frame looping WALK CYCLE sprite sheet of the SAME character: 3 ROWS and 4 COLUMNS. Row 1 = the left figure's direction, row 2 = the middle figure's direction, row 3 = the right figure's direction. The 4 columns are the 4 phases of the walk, left to right: 1 = contact: left foot forward with its heel on the ground, right foot back, right arm swung forward; 2 = passing: legs together under the body, right foot lifted a little as it passes, arms by the sides; 3 = contact: right foot forward, left foot back, left arm swung forward; 4 = passing: legs together, left foot lifted a little, arms by the sides. Small natural steps, feet never wider apart than the shoulders. In every frame the head and torso face EXACTLY the same angle as that row's standing figure: do not turn the head, do not turn the body sideways, only the legs and arms move. Same size and proportions as the standing figures, same clothes, face, hair, accessories and shoes, same pixel-art style, outline and shading. Row 3 walks AWAY from the viewer like the right standing figure: in all 4 frames of row 3 we see the back of the head and the back, never the face. All 12 figures the same height, feet on one baseline per row. Leave clear magenta gaps between all 12 figures. Flat solid magenta (#FF00FF) background everywhere, no shadows, no grid lines, no labels, no added text.
  234. </details>
  235. ## Chat
  236. | Command | Description |
  237. |---------|-------------|
  238. | `/status` | Office stats — agents, clients |
  239. | `/agents` | List active agents |
  240. | `/recap` | Today so far, as the office manager tells it — sessions, agents, tasks, deploys, failures, incidents, payroll |
  241. | `/incident` | Declare an incident by hand |
  242. | `/all-clear` | End the incident and post the postmortem |
  243. | `/help` | Show available commands |
  244. | `/the-office` | Toggle Dunder Mifflin mode |
  245. To wipe the chat history, run `python3 scripts/chat-post.py /clear` from the checkout.
  246. ### Agent Routing
  247. The chat AI routes your messages to specialist agents based on keywords:
  248. | Topic | Agent |
  249. |-------|-------|
  250. | bugs, errors, crashes | Debugger |
  251. | PRs, code review, git | Reviewer |
  252. | UI, CSS, design | Frontend |
  253. | tests, coverage, e2e | Tester |
  254. | auth, security, tokens | Security |
  255. | deploys, Docker, CI | DevOps |
  256. | performance, caching | PerfEng |
  257. | databases, SQL | DBA |
  258. | TypeScript, types | TS Pro |
  259. | AI, LLMs, prompts | AI Eng |
  260. | APIs, REST, webhooks | Fullstack |
  261. | architecture, patterns | Architect |
  262. Agents can also message each other directly — see [Agent-to-agent messages](docs/reference.md#agent-to-agent-messages).
  263. ### Just me and Claude — chatting in the office
  264. ![Me & Claude](docs/images/Me%20&%20Claude.png)
  265. ## Modes
  266. | URL | Mode |
  267. |-----|------|
  268. | `127.0.0.1:3333` | Live — connected to Claude Code via WebSocket |
  269. | `127.0.0.1:3333?sim` | Simulation — scripted demo with fake agents |
  270. | `127.0.0.1:3333?video` | Video — scripted recording mode |
  271. | `127.0.0.1:3333?helper` | Placement helper — dev tool for positioning furniture |
  272. | `127.0.0.1:3333?sim&rooms=all` | Rooms preview — the corridor, meeting room, server room and lunch room on placeholders, before their art ([Rooms](docs/reference.md#rooms)) |
  273. | `127.0.0.1:3333?variant=incident` | Incident — pins "Prod Is Down" on |
  274. | `http://<lan ip>:3335/#viewer=…` | Phone, watch-only — `npm run lan` prints this link and a QR code: the office scene alone, on a phone on your Wi-Fi ([Phone mode](docs/reference.md#phone-mode)) |
  275. | `https://<lan ip>:3335/#phone=…` | Phone, full office — `npm run lan -- --full` prints this link, a QR code and a certificate fingerprint to compare on the first visit: chat, permission cards you can answer, meters, settings and the inspector, over HTTPS only ([Phone mode](docs/reference.md#phone-mode)) |
  276. | `127.0.0.1:3333?season=christmas` | Christmas — the festive office any day (on by itself 1 Dec – 6 Jan) |
  277. | `127.0.0.1:3333?season=autumn` | Any season or holiday by name, any day: `spring`, `summer`, `autumn`, `winter`, `halloween`, `easter`, `valentine` ([Seasons](docs/reference.md#seasons)) |
  278. | `127.0.0.1:3333?season=none` | No seasonal art, whatever the date |
  279. The theme, day/night mode, season and sound are also in **Settings** (the ⚙ at the right of the title bar) and are remembered per browser; a `?theme=` or `?season=` in the address still wins over what is stored there.
  280. ## Tech Stack
  281. - **Frontend**: React + TypeScript + Vite
  282. - **Server**: Express + WebSocket (ws)
  283. - **Storage**: SQLite (better-sqlite3)
  284. - **Chat AI**: Claude CLI (`claude -p`)
  285. - **Sprites**: Custom pixel art (isometric)
  286. - **Desktop**: Electron (optional)
  287. - **Tests**: Vitest, run in CI on every pull request
  288. ## Project Structure
  289. ```
  290. Claude-Office/
  291. ├── src/ # React frontend
  292. │ ├── components/ # Character, SlackChat, AgentCard, TaskBoard…
  293. │ ├── officeReducer.ts # Every office event → what the office does
  294. │ ├── styles/ # office.css, incident.css…
  295. │ └── App.tsx # Main app
  296. ├── server/ # Express + WebSocket server
  297. │ ├── index.js # HTTP endpoints + WS broadcast
  298. │ └── chat-db.js # SQLite wrapper
  299. ├── hooks/ # Claude Code hooks
  300. │ ├── agent-tracker.sh # Forwards events to the server
  301. │ ├── agent-tracker.py # Turns a hook payload into the office event
  302. │ ├── status-line.sh # Feeds the meters
  303. │ └── install-hooks.sh # npm run install-hooks
  304. ├── scripts/ # start / stop / doctor / chat watcher
  305. ├── electron/ # Desktop app
  306. ├── public/sprites/ # Pixel art characters + effects
  307. └── docs/ # Reference + images
  308. ```
  309. ## Security
  310. - Server binds to `127.0.0.1` only — not exposed to the network. Phone mode is opt-in: `npm run lan` adds a separate watch-only listener on your LAN address (no API routes, its own viewer key, no prompts, commands, paths or task text); `npm run lan -- --full` serves the full office there instead, over HTTPS only, with a certificate made on this machine (compare its printed fingerprint on the first visit: nobody signed it), its own phone secret and a short allowlist of routes; and `AGENT_OFFICE_ALLOWED_HOSTS` lets `tailscale serve` reach the loopback server ([Phone mode](docs/reference.md#phone-mode))
  311. - Agent events, permission answers and wiping the chat need the auth token in `~/.agent-office/auth-token` (`0600` permissions); typing in the chat doesn't
  312. - The office page gets the token from the link the start script opens; without it the office is read-only
  313. - Hook requests are signed, so the token never appears on a command line
  314. The full model is in the [reference](docs/reference.md#security).
  315. ## Desktop App (Electron)
  316. Download it from [Releases](https://github.com/W17ant/Claude-Office/releases), or build it yourself:
  317. ```bash
  318. npm run dev:electron # Development
  319. npm run build:electron # Build the installer
  320. ```
  321. The app keeps itself up to date: when a newer release is out it downloads it in the background, and the tray menu (also on right-click in the window) offers **Restart to update**. Untick **Update automatically** in the same menu and it only tells you a new version is there, with a link to the download. How it works on each platform, and when it falls back to the download link, is in the [reference](docs/reference.md#desktop-app-electron).
  322. ## Community
  323. - **Got an idea?** Suggest it, or vote on others, in [Discussions › Ideas](https://github.com/W17ant/Claude-Office/discussions/categories/ideas)
  324. - **Made the office your own?** Show it in [Show and tell](https://github.com/W17ant/Claude-Office/discussions/categories/show-and-tell)
  325. - **Built something in a fork?** Bring it back and get credited in the changelog: [CONTRIBUTING › Got something in your fork?](CONTRIBUTING.md#got-something-in-your-fork)
  326. - **Want to help?** Issues labelled [help wanted](https://github.com/W17ant/Claude-Office/labels/help%20wanted) are open for anyone
  327. Bug reports and pull requests are welcome too; see [CONTRIBUTING.md](CONTRIBUTING.md).
  328. ## License
  329. MIT — the Dunder Mifflin fan art is excluded, see [NOTICE.md](NOTICE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.