Duun documentation
How to build factories, write workflows, configure agents and connect Duun to the rest of your stack. For answers about using the app, see the help center.
Quickstart
From a Linear issue to a reviewed pull request, with you approving the plan.
- Connect GitHub and Linear Install the Duun app on your repos and sign in to your tracker.
- Create a factory from a template Ship features gives you plan, build, test, review and merge.
- Start a run and approve the plan Press C, describe the work, and answer the ask in Inbox.
$ npm install -g @duun/cli
$ duun login
✓ Signed in to acme as [email protected]
$ duun run "Add idempotency keys to refund webhooks" --factory fac_platform --watch
▸ run_7f3aK2pQ queued on Base Loop v5
▸ plan · builder · opus-5.5
◆ waiting · Approve the plan → https://app.duun.ai/r/run_7f3aK2pQ How the pieces fit
Every run belongs to a workflow, every workflow to a factory. Select a piece to read about it.
Browse the docs
-
The model in ten minutes, then a factory that turns an issue into a merged pull request.
-
Steps, gates, decisions, references, triggers and limits: everything a run goes through.
-
Built-in and custom agents, the runtimes and models they use, and what they may do without asking.
-
Teach agents with SKILL.md, give people slash commands, and share both on Explore.
-
Connect 59 tools with OAuth or API keys, or any MCP server over HTTP.
-
Cloud sandboxes, desktops and your own SSH machines, with snapshots and port forwarding.
-
API reference
PreviewREST endpoints for runs, factories, workflows, agents, skills, commands, webhooks and usage.
-
Signed events for runs, asks, pull requests and budgets, and trigger URLs that start runs.
-
CLI
PreviewStart runs, follow logs and manage workflows as files from your terminal and CI.
-
SDKs
PreviewTyped clients for TypeScript and Python with pagination, retries and webhook helpers.
-
Isolation, secrets, retention and the controls admins have over agents.