中文 · Documentation · Getting Started · DotCraft
The project board where agents collaborate with you.
Oratorio is an agent-addressable project board, powered by DotCraft. It turns local tasks, GitHub/GitLab issues, and pull or merge requests into one durable board where agents and operators can coordinate review, implementation, follow-up work, and source-backed delivery.
- Agent-addressable board: scoped Oratorio tools let agents list and read board items, create local tasks, and queue review rounds without turning the board into free-form chat state.
- Work-first source model: Local Tasks, GitHub/GitLab issues, and PRs/MRs share the same Task board, lifecycle, comments, rounds, decisions, and timeline.
- Typed drafts: review, implementation, and follow-up work is submitted through Oratorio runtime tools as structured drafts, not parsed from free-form model text.
- Delivery handoff: Implementation Drafts can stay manual or move through backend delivery to create a generated GitHub PR or GitLab MR with Source Write history.
- DotCraft-powered execution: Oratorio owns board state, workflow state, drafts, and source writes; DotCraft remains the detailed agent execution surface, with code-changing runs using Oratorio-managed Git worktrees.
For local development, start from the desktop app:
.\dev.batYou can also run the server directly:
dotnet build Oratorio.sln
dotnet run --project server/Oratorio.Server.csprojRequirements, source setup, release builds, and test commands live in the development guide.
Connect Oratorio to a DotCraft session and let the Agent manage your board.
| Goal | Document |
|---|---|
| Install, run, and understand the first local flow | Getting Started |
| Build, test, and contribute to the codebase | Development |
| Review Settings fields, state paths, DotCraft routing, and automation policy | Configuration |
| Configure GitHub repositories, GitHub App, webhooks, and PR delivery | GitHub Integration |
| Configure GitLab projects, tokens, webhooks, and MR delivery | GitLab Integration |
| Check what works locally and what still depends on external sources | Local Support Matrix |
Inspired by openai/symphony and built on DotCraft, the Agent Harness and AppServer runtime that powers its agent execution workflow.
Apache License 2.0