Skip to content

arxdsilva/agent-office / .claude/skills/run-office

run-office

Verified

Launch 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

  1. Quick visual check (headless, isolated profile): make build, then drive the built app with Playwright _electron:
    • _electron.launch({ args: ['.'], cwd: 'packages/desktop', env })
    • env is process.env without any ELECTRON_* vars, plus AGENT_OFFICE_USER_DATA, AGENT_OFFICE_HOME and CLAUDE_SETTINGS_FILE pointing 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.
  2. Interactive: make dev-mock opens the window with hot reload, simulated agents and your live Claude Code sessions. Then:
    • make demo-event adds a custom zone with a "Demo" agent.
    • make demo-message messages the first agent.
  3. 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/).
  4. Stop every app instance you started (app.close() or tray → Quit). Never kill processes you didn't start.

Troubleshooting

SymptomCause / fix
SyntaxError: … 'electron' does not provide an export named …, "Node.js vXX" in the outputELECTRON_RUN_AS_NODE=1 inherited from VS Code/Cursor. Use make targets or strip ELECTRON_* from the env.
Red "Port … is busy" bannerAnother instance or process owns the port. Change it in Settings or use PORT= for this run.
Window opens but shows nothingRun make build again (stale out/), or check the devtools console for CSP errors.
Office shell renders but no building/charactersAssets missing or LFS pointers: git lfs pull, or build them with make assets (see /asset-change).
Low FPS in the headless/CI runExpected with software GL. Pick Settings → Graphics → Low, or measure locally with make perf.
No Claude Code sessionsThe 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.
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall