arxdsilva/agent-office / .claude/skills/desktop-change
desktop-change
VerifiedChange agent-office's desktop shell — tray menu, native notifications, settings, IPC channels, windows, the auto-updater, packaging/installers or icons. Use for edits under packages/desktop/ (main, preload, electron-builder.yml, e2e) or to core domain tray/attention/update/settings logic.
Change the desktop shell
Rules: PRIVACY_SECURITY.md (Electron checklist), ARCHITECTURE.md, TESTING.md.
- Decide in the core first (red → green):
- What the tray shows:
core/src/domain/tray.ts - When to notify:
core/src/domain/attention.ts - Update policy:
core/src/domain/update-policy.ts - Settings fields:
shared/src/desktop-api.tsSettingsSchema(additive, with defaults) andcore/src/domain/settings.ts(restart fields)
- What the tray shows:
- IPC: add the channel name to
shared/src/ipc-channels.tsand the method toAgentOfficeApi(additive). Then add the handler indesktop/src/main/ipc-api.ts, zod-validated, with a test inipc-api.test.ts, and the bridge indesktop/src/preload/index.ts. - Electron adapter: keep it thin (
desktop/src/main/adapters/electron-*.ts). Logic stays in the core. - Wiring:
composition.tsandcomposition.test.ts(fakeShell). - Renderer: view model → controller → DOM adapter (see
/scene-changefor 3D). - App E2E: add or extend a spec in
packages/desktop/e2e/(isolated profile frome2e/app.ts), thenmake build test-ui. - Security review against the Electron checklist: no new permissions, no Node in the renderer, the CSP is unchanged, and the IPC is validated and sender-checked.
- Packaging changes: run
make package, launch the unpacked app once, and run the hook wrapper from Settings → Install (tempCLAUDE_SETTINGS_FILE). Runmake iconsafter editingbuild/*.svg.
Theme: desktop/src/main/theme.ts (pure) applies the theme setting to nativeTheme.themeSource and the window background; desktop/e2e/theme.spec.ts checks both themes and contrast (drop Playwright's color-scheme emulation with emulateMedia({ colorScheme: null })). Quitting with managed sessions asks first (createQuitGuard).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |