How agiflow/doompi works
DoomPi is a composable distribution of the Pi coding agent: users choose modes, domains and optionally profiles, then launch a session with only the selected tools and skills. The CLI resolves that composition and prepares the runtime; the active session then exposes domain capabilities such as tasks, Git worktrees, sandboxing, voice and structured feedback. The graph also preserves major README capabilities whose runtime wiring is not shown in the sampled sources. Dashed, uncited links indicate unverified integration; source excerpts are limited, so these do not assert specific calls.
Main entry points: composition.ts Composition resolver · web Web cockpit · src Doom config · router.ts CLI launcher
Components 19
Session composition
- Doom config
packages/foundations/doompi-config/src - Domains
packages - Profiles
packages/foundations/doompi-config/src - CLI launcher
packages/cli/doompi/src/cli/router.ts - Composition resolver
packages/cli/doompi/src/builders/cli/composition.ts - Harness context
packages/cli/doompi/src/builders/cli/harnessContext.ts
Agent runtime
- Pi agent session
- Core session services
packages/core/doompi-core/src
Work capabilities
- Persistent tasks
layers/task/doompi-task/src - Git worktrees
layers/source-control/doompi-git/src - Sandbox execution
layers/sandbox/doompi-sandbox/src - Workflow automation
packages/minor/doompi-workflow/src
Context and access
- Model guidance
layers/llm/doompi-model-guidance/src - MCP access
packages/default/doompi-mcp/src
User interfaces
- Structured feedback
layers/ask-user/doompi-user-feedback/src - Voice mode
packages/minor/doompi-voice/src - Web cockpit
packages/clients/doompi-web/src/web - Story preview
layers/design/doompi-style-system/src
Other components
- Engineer
Connections 20
- Engineer → Doom config: selects composition
README.md - Doom config → Composition resolver: configures
- Composition resolver → Harness context: prepares session
packages/cli/doompi/src/builders/cli/composition.ts - Harness context → Pi agent session: starts with resources
- Engineer → CLI launcher: launches
README.md - CLI launcher → Composition resolver: composes session
- Domains → Pi agent session: adds selected tools
- Profiles → Pi agent session: supplies persona
- Pi agent session → Core session services: uses session services
- Pi agent session → Persistent tasks: uses persistent tasks
- Pi agent session → Git worktrees: uses worktrees
- Pi agent session → Sandbox execution: uses sandbox
- Pi agent session → Workflow automation: dispatches workflows
- Pi agent session → Model guidance: loads guidance
- Pi agent session → MCP access: uses scoped MCP
- Pi agent session → Structured feedback: asks questions
- Pi agent session → Voice mode: supports voice
- Engineer → Web cockpit: operates cockpit
- Web cockpit → Core session services: accesses session APIs
- Story preview → Web cockpit: offers story preview