arxdsilva/agent-office / .claude/skills/run-office
run-office
VerifiedLaunch the agent-office desktop app locally and verify a change in the real UI (screenshot). Use when asked to run, start, demo or screenshot the app, or before calling any scene/UI/desktop change done.
Run the app and look at it
- Quick visual check (headless, isolated profile):
make build, then drive the built app with Playwright_electron:_electron.launch({ args: ['.'], cwd: 'packages/desktop', env })envisprocess.envwithout anyELECTRON_*vars, plusAGENT_OFFICE_USER_DATA,AGENT_OFFICE_HOMEandCLAUDE_SETTINGS_FILEpointing at a temp dir,AGENT_OFFICE_MOCK=1,AGENT_OFFICE_CLAUDE=0,PORT=4318.packages/desktop/e2e/app.ts(launch()) already does this.- Then
win.screenshot()and read the image.
- Interactive:
make dev-mockopens the window with hot reload, simulated agents and your live Claude Code sessions. Then:make demo-eventadds acustomzone with a "Demo" agent.make demo-messagemessages the first agent.
- Check:
- The atrium (elevators, reception, cafe) and Main Street load; there is one themed wing per provider with its id on the sign.
- Agents sit exactly at desks, one desk pod per topic, subagents next to their parent. Parents with subagents walk into a meeting room; waiting agents go to a glowing phone booth; idle agents drift to the kitchen, lounge or cafe; new agents arrive by elevator and finished ones leave by it. No snapping or foot sliding.
- Name tags readable; the panel's "Now" line says where the agent is ("Waiting for you in booth 3").
- Status colors match the legend.
- Clicking a tag opens the chat; sending goes ⏳ → ✓ → ✓✓ with a reply from mock agents.
- ⚙ Settings shows the hook state, and Graphics → quality applies immediately.
- Closing the window keeps the tray icon.
- No errors in the console (CSP violations show up here: assets load from
app://renderer/assets/).
- Stop every app instance you started (
app.close()or tray → Quit). Never kill processes you didn't start.
Troubleshooting
| Symptom | Cause / fix |
|---|---|
SyntaxError: … 'electron' does not provide an export named …, "Node.js vXX" in the output | ELECTRON_RUN_AS_NODE=1 inherited from VS Code/Cursor. Use make targets or strip ELECTRON_* from the env. |
| Red "Port … is busy" banner | Another instance or process owns the port. Change it in Settings or use PORT= for this run. |
| Window opens but shows nothing | Run make build again (stale out/), or check the devtools console for CSP errors. |
| Office shell renders but no building/characters | Assets missing or LFS pointers: git lfs pull, or build them with make assets (see /asset-change). |
| Low FPS in the headless/CI run | Expected with software GL. Pick Settings → Graphics → Low, or measure locally with make perf. |
| No Claude Code sessions | The adapter is off, or no transcript was modified in the last 10 minutes. |
| Messages to a Claude Code session stay ⏳ | The hook isn't installed (Settings), or the session is idle. Delivery happens at the next turn boundary. |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |