Oratorio
Oratorio is DotCraft's built-in project board for local tasks, GitHub issues and pull requests, and GitLab issues and merge requests. Use it to hand work to agents, follow each run, review the result, and deliver approved changes without leaving DotCraft Desktop.
Start with a local task
- Open a Git repository as a project in DotCraft Desktop.
- Select Oratorio in the sidebar.
- Select New local task, then enter the problem and choose the repository and base branch.
- Open the card and choose an available action under Start Agent work.
- Follow the run in Quick View or open the full task when it is ready for review.
Oratorio creates an isolated managed worktree for Agent work. Your active checkout remains unchanged while the run is in progress.
Connect external work
Add a project in Oratorio settings to synchronize work from a source provider:
- Connect GitHub with a GitHub App.
- Connect GitLab with a project-scoped token.
Source writes are disabled until you explicitly enable them. Manual and scheduled sync work without a public webhook endpoint.
Use Oratorio in a conversation
Install Oratorio, open its plugin details, and select Connect to connect the current workspace.
Open the target conversation, select Apps, and enable Oratorio.
Turning off Oratorio in Apps only removes it from that conversation. Disconnect in the plugin details revokes the current workspace connection and its related conversation bindings. See Connected Apps for the complete connection and authorization flow.
Local and remote use
In local mode, Desktop starts the bundled Oratorio Server when you first open the feature. DotCraft Hub manages the process, and Oratorio stores its user-level state under ~/.craft/oratorio/.
For a remote deployment, connect Desktop to a DotCraft Stack. The same Board and task operations remain available. Server administration settings are read-only from a remote Desktop connection.