How potato-dev-inc/puppet-master works
Puppet Master is a control room for delegating work to real coding-agent terminal sessions, not an agent that implements changes itself. An orchestrator submits work through the desktop or MCP surface; the bridge coordinates durable operations and worker panes, and run handling reports completion separately from acceptance-check results. Worktrees isolate parallel changes, while checkpoints support review and undo. The repository also contains distinct issue-intake, CI-fix, mission, and handoff workflows. Edges are limited to README-documented relationships and sampled calls; several feature modules are represented from the source index and tree, not inspected implementation.
Main entry points: agent_runs.rs Agent runs · router.rs HTTP bridge · src Desktop app · operations.rs Durable operations
Components 22
User surfaces
- Desktop app
packages/app/src - Sidebar session
packages/app/src/components/sidebar/useOrchestratorSession.ts - MCP shim
packages/mcp-server/src/tool-router.ts - CLI watcher
packages/cli/src/launch-worker.ts - Mobile PWA
packages/app/src
Bridge and coordination
- HTTP bridge
packages/app/src-tauri/src/bridge/router.rs - Durable operations
packages/app/src-tauri/src/operations.rs - Human questions
packages/app/src-tauri/src/questions/mod.rs - Audit log
packages/app/src-tauri/src/audit/mod.rs
Worker execution
- Agent runs
packages/app/src-tauri/src/agent_runs.rs - Agent adapters
packages/app/src-tauri/src/agent_adapters - Terminal panes
packages/app/src-tauri/src/pty
Workspace safety
- Worktree isolation
packages/app/src-tauri/src/worktrees/mod.rs - Checkpoints and undo
packages/app/src-tauri/src/checkpoints/engine.rs - Acceptance checks
packages/app/src-tauri/src/agent_runs/checks.rs
Product workflows
- Issue intake
packages/app/src-tauri/src/issue_intake/engine.rs - CI fixes
packages/app/src-tauri/src/ci_fix/engine.rs - Missions
packages/app/src-tauri/src/missions/engine.rs - Keep going
packages/app/src-tauri/src/handoff/keep_going/brief.rs - Coordination kernel
packages/app/src-tauri/src
Other components
- Orchestrator
- Coding-agent TUI
Connections 24
- Orchestrator → MCP shim: submits tools
README.md - Orchestrator → Desktop app: delegates work
README.md - MCP shim → HTTP bridge: calls HTTP API
README.md - Mobile PWA → HTTP bridge: proxies requests
README.md - CLI watcher → HTTP bridge: watches turns
README.md - Desktop app → HTTP bridge: hosts API
README.md - Sidebar session → Agent runs: runs orchestration
packages/app/src/components/sidebar/useOrchestratorSession.ts - Sidebar session → HTTP bridge: creates executor
packages/app/src/components/sidebar/useOrchestratorSession.ts - HTTP bridge → Durable operations: routes operations
- Durable operations → Agent runs: dispatches worker
packages/app/src-tauri/src/agent_runs.rs - Agent runs → Agent adapters: selects backend
- Agent runs → Terminal panes: drives sessions
- Agent runs → Worktree isolation: isolates work
- Agent runs → Acceptance checks: checks outcome
packages/app/src-tauri/src/agent_runs.rs - Agent runs → Durable operations: persists turns
README.md - Agent runs → Human questions: requests input
- Durable operations → Orchestrator: returns result
README.md - Worktree isolation → Checkpoints and undo: supports undo
- Desktop app → Issue intake: offers workflow
- Desktop app → CI fixes: offers workflow
- Desktop app → Missions: offers workflow
- Desktop app → Keep going: offers handoff
- HTTP bridge → Coordination kernel: exposes coordination
README.md - Coding-agent TUI → Terminal panes: edits code
README.md