How kashiwagieri233/palette works
Palette is a managed QEMU desktop service with two principal workflows: MCP agents observe a bounded screenshot and submit frame-bound actions, while Desktop/CLI users create and manage persistent VMs, view them, and take exclusive input control. The runtime centralizes authorization, scheduling, auditing, VM lifecycle, and guest integrations. The README documents the cross-process product paths; source-index references support several internal dependencies, but many implementation details were not sampled, so those links are omitted or marked unverified.
Main entry points: service.py Palette service · App.tsx Desktop workbench · manager.py VM lifecycle · bridge.py Guest tool bridge
Components 22
Clients
- Desktop workbench
desktop/src/renderer/App.tsx - Built-in agent
desktop/src/main/agent-client.ts - Live screen console
desktop/src/renderer/Console.tsx
Service interfaces
- MCP server
src/palette/server.py - Operator IPC
src/palette/operator/server.py - Desktop IPC
desktop/src/main/ipc.ts - Palette service
src/palette/service.py
Policy and control
- Authorization
src/palette/policy.py - Control lease
src/palette/control.py - Action scheduler
src/palette/input/controller.py - Metadata audit
src/palette/audit.py
VM runtime
- VM lifecycle
src/palette/vm/manager.py - Persistent VM storage
src/palette/persistent_storage.py - Image manager
src/palette/vm/images.py - QEMU launcher
src/palette/vm/launcher.py - QMP client
src/palette/qmp/client.py
Guest integrations
- Guest tool bridge
src/palette/guest_tools/bridge.py - Guest tool contract
src/palette/guest_tools/base.py - Windows enhancements
guest/windows/Palette.Operations.cs
Other components
- MCP agent
- Palette Desktop
- Operator CLI
Connections 25
- MCP agent → MCP server: uses MCP
README.md - MCP server → Palette service: dispatches tools
src/palette/server.py - Palette Desktop → Desktop workbench: operates workbench
README.md - Desktop workbench → Desktop IPC: requests runtime
- Desktop IPC → Operator IPC: uses local IPC
README.md - Operator CLI → Operator IPC: uses local IPC
README.md - Operator IPC → Palette service: dispatches commands
src/palette/operator/server.py - Desktop workbench → Live screen console: views live screen
README.md - Desktop workbench → Control lease: requests takeover
README.md - MCP agent → Built-in agent: prompts built-in agent
- Built-in agent → Desktop IPC: invokes agent API
desktop/src/main/agent-client.ts - Palette service → Authorization: authorizes requests
src/palette/service.py - Palette service → VM lifecycle: dispatches VM operations
src/palette/service.py - Palette service → Action scheduler: schedules actions
src/palette/service.py - Palette service → Metadata audit: records events
src/palette/service.py - Palette service → Control lease: checks ownership
src/palette/service.py - Action scheduler → QMP client: sends input
src/palette/input/controller.py - VM lifecycle → QEMU launcher: starts instances
src/palette/vm/manager.py - QEMU launcher → QMP client: opens management channel
- VM lifecycle → Guest tool bridge: manages guest tools
src/palette/vm/manager.py - Guest tool bridge → Guest tool contract: implements contract
- Guest tool bridge → Windows enhancements: exposes guest operations
README.md - VM lifecycle → Persistent VM storage: manages disk state
src/palette/persistent_storage.py - Persistent VM storage → Image manager: inspects images
src/palette/persistent_storage.py - Image manager → QEMU launcher: supplies image paths
src/palette/vm/images.py