How block/builderbot works
Builderbot is a monorepo of desktop developer tools: Staged manages projects, branches, agent sessions and Git/PR pipelines; Differ presents repository diffs and review context; Penpal provides a project/file review interface and server. The main Staged workflow runs from the desktop shell through project/branch operations into queued session work, with results persisted and exposed to the UI. Differ and Penpal are separate product branches. The graph follows documented app scope and indexed source references; unsampled implementation details and unshown runtime wiring are intentionally not inferred.
Main entry points: pipeline.rs Pipeline Sessions · mod.rs SQLite Store · kick.rs Session Queue · server.go Penpal Server
Components 24
Staged Desktop
- Staged Shell
apps/staged/src/App.svelte - UI Transport
apps/staged/src/lib/transport.ts - Pipeline Progress
apps/staged/src/lib/features/sessions/PipelineSteps.svelte
Staged Runtime
- Branch Operations
apps/staged/src-tauri/src/branches.rs - Session Commands
apps/staged/src-tauri/src/session_commands.rs - Session Runner
apps/staged/src-tauri/src/session_runner.rs - Session Queue
apps/staged/src-tauri/src/session_queue/kick.rs - Pipeline Sessions
apps/staged/src-tauri/src/prs/pipeline.rs - Branch Context
apps/staged/src-tauri/src/prs/context.rs - Git Pipelines
apps/staged/src-tauri/src/prs/git_pipeline.rs - Push Pipeline
apps/staged/src-tauri/src/prs/push.rs - Commit Pipeline
apps/staged/src-tauri/src/prs/commit.rs - Pipeline Gates
apps/staged/src-tauri/src/pipeline_dependency.rs - SQLite Store
apps/staged/src-tauri/src/store/mod.rs - Web Server
apps/staged/src-tauri/src/web_server.rs
Differ
- Diff Workspace
apps/differ/src/App.svelte - Native Commands
apps/differ/src/lib/commands.ts - Preferences
apps/differ/src/lib/preferences.svelte.ts
Penpal
- Penpal CLI
apps/penpal/cmd/penpal-cli/main.go - Penpal Server
apps/penpal/internal/server/server.go - Review UI
apps/penpal/frontend/src/App.tsx - Agent Manager
apps/penpal/internal/agents/manager.go - Comment Storage
apps/penpal/internal/comments/storage.go
Other components
- Developer
Connections 28
- Developer → Staged Shell: uses
README.md - Staged Shell → UI Transport: calls
apps/staged/src/App.svelte - UI Transport → Web Server: communicates with
- Web Server → Branch Operations: routes to
apps/staged/src-tauri/src/branches.rs - Branch Operations → SQLite Store: reads and writes
apps/staged/src-tauri/src/branches.rs - Branch Operations → Session Queue: dispatches
apps/staged/src-tauri/src/branches.rs - Session Commands → Session Runner: starts
- Session Queue → Session Runner: starts queued work
- Session Queue → SQLite Store: reads and writes
- Pipeline Sessions → SQLite Store: persists session
apps/staged/src-tauri/src/prs/pipeline.rs - Pipeline Sessions → Branch Context: resolves context
apps/staged/src-tauri/src/prs/pipeline.rs - Git Pipelines → Pipeline Sessions: starts pipeline
apps/staged/src-tauri/src/prs/git_pipeline.rs - Git Pipelines → Branch Context: resolves branch
apps/staged/src-tauri/src/prs/git_pipeline.rs - Push Pipeline → Pipeline Sessions: queues work
apps/staged/src-tauri/src/prs/push.rs - Push Pipeline → Git Pipelines: rebuilds queued work
apps/staged/src-tauri/src/prs/push.rs - Commit Pipeline → Pipeline Sessions: shares session plumbing
apps/staged/src-tauri/src/prs/pipeline.rs - Pipeline Gates → SQLite Store: checks dependency
apps/staged/src-tauri/src/pipeline_dependency.rs - Pipeline Sessions → Session Queue: queues sessions
apps/staged/src-tauri/src/prs/pipeline.rs - Session Runner → SQLite Store: updates state
- Pipeline Progress → UI Transport: subscribes to events
apps/staged/src/lib/features/sessions/PipelineSteps.svelte - Developer → Diff Workspace: uses
README.md - Diff Workspace → Native Commands: calls
apps/differ/src/App.svelte - Diff Workspace → Preferences: initializes
apps/differ/src/App.svelte - Developer → Review UI: uses
apps/penpal/frontend/src/App.tsx - Review UI → Penpal Server: requests data
- Penpal CLI → Penpal Server: starts server
- Penpal Server → Agent Manager: uses agents
- Penpal Server → Comment Storage: stores comments