On this page
01
Before you start
Duet is in early access on the AI Growth and Enterprise plans. Ask for early access, and we set it up with you.
- An owner or admin of your Cloptima org
- A Slack workspace where you can install apps
- A GitHub organization where you can install apps, for work on code
- Model access: your own provider API keys in Cloptima, or Cloptima credits
02
Connect Slack, and Duet is set up
In Cloptima, open Settings → Integrations and connect Slack as an org owner or admin. This sets Duet up: Cloptima creates an AI policy named Duet policy. It is an ordinary policy, so your admins can see it, change it, or delete it in AI → Policies.
03
Choose the repositories Duet may work on
Duet works on code through its own GitHub App, separate from the read-only Cloptima Assist app. In Settings → Integrations, connect Cloptima Duet (GitHub) and choose the repositories on GitHub's install page. You can add or remove repositories there at any time.
- Duet clones the repositories you choose and runs their tests in its own sandbox
- It pushes only to its own branches, named duet/…
- It opens pull requests, always as drafts
- It reads the CI logs on its pull requests and never reruns a workflow
04
Pick the model and spend limits
Open Settings → Duet. Owners and admins change these settings; members can see them.
- 1
Choose the model family
Pick Claude, GPT, or Gemini, from the families the Duet policy allows. New conversations run on the family you pick.
- 2
Set the spend limits
In AI → Policies, set the Duet policy's daily and monthly budgets. They are hard limits: once Duet reaches one, its next model call is refused.
- 3
Attach your guardrails
Your org's guardrail baseline applies to Duet like the rest of your AI traffic. To mask secrets and personal data on Duet's calls in particular, attach a guardrail profile to the Duet policy.
General
- Duet is on
- Turn off to pause Duet for everyone in your organization.On
- 1Model family
- Claude
Duet uses this family's models.
GitHub
- Open pull requests
- On
Sandbox access
- Web fetch and search
- On
05
Invite Duet and tag it in a thread
In Slack, invite @Duet to a channel, then mention it in a thread. Any full member of the workspace can ask; guests can't.
- 1
Ask in a thread
Duet reads the thread, does the work in its own sandbox, and replies in the same thread, with files.
- 2
Review the draft pull request
For work on code, it opens a draft pull request in a repository you chose. Your team reviews and merges it.
- 3
Keep going
A failed CI check, or a reviewer who mentions @Duet on its pull request, starts a new task in the same thread.
06
See what Duet did
AI → Duet → Activity lists each Slack mention and each GitHub event on Duet's pull requests, newest first, with how each one ended. It keeps no message text. Open a task's steps to see each step's model, tools, and cost.
07
Tighten access, or turn Duet off
The switches in Settings → Duet narrow what Duet can do, and one turns it off.
| Switch | When it is off |
|---|---|
| Web fetch and search | New sandboxes reach only package mirrors and GitHub, and Duet doesn't search the web. |
| Open pull requests | Duet pushes its branch and replies with a compare link, so a person opens the pull request. It doesn't review new pull requests either. |
| Duet is on | Each new mention gets a note that Duet is turned off, and no sandbox runs. A task already running finishes. |