Oratorio

Oratorio is DotCraft's built-in project board. Local tasks, GitHub issues and pull requests, and GitLab issues and merge requests all land on the same Board. Hand work to an Agent, follow the run, review the result, and deliver approved changes back to the provider, all without leaving DotCraft Desktop.

Start with a local task

You can run Oratorio before connecting any provider:

1. Open a Git repository as a project in DotCraft Desktop.
2. Select Oratorio in the sidebar.
3. Select New local task, describe the problem, and choose the repository and base branch.
4. Open the card and pick a run mode under Start Agent work.
5. Follow the run in Quick View, then open the full task once it is ready for review.

Agent work happens in a worktree Oratorio creates for the run, so the checkout you are using stays untouched. For the full path from filtering the Board to reviewing and delivering, see the Oratorio workflow.

Connect GitHub and GitLab

Select Connect GitHub or Connect GitLab on the Board and the guided flow takes you from credentials to a first sync. GitHub connects through a GitHub App, and GitLab through a project-scoped token.

Oratorio writes nothing back to a provider until you enable it. A public webhook endpoint is optional, since manual and scheduled sync work without one. Project-to-workspace mapping, Agent execution, and automation are set in Configure Oratorio.

Use Oratorio in a conversation

Connect Oratorio to a conversation to read and move tasks from the chat itself.

1. Install Oratorio, open its plugin details, and select Connect to connect the current workspace.

   

2. Start a new conversation. Oratorio is available in it from the first message.

Disconnect in the plugin details removes Oratorio from every conversation in the workspace. See Connected Apps for the full connection and authorization flow.

Local and remote deployments

In local mode, Desktop starts the bundled Oratorio Server the first time you open the feature. There is nothing extra to install.

For a remote deployment, connect Desktop to a DotCraft Stack. The Board and task operations are identical. Server administration settings are read-only over a remote connection.

Related docs

• Oratorio workflow — the full path from finding a task on the Board to reviewing and delivering it
• Configure Oratorio — provider connections, project mapping, and Agent execution policy