| Claude Code | Everything: the ${registry.desks.length - 1} desks as native subagents with the repo's tools, the Manager in your session, the loop, proof, the dashboard, video. |
|---|
| Codex, Cursor, Gemini CLI, Copilot, Windsurf, OpenCode | npx deskstudio add writes a rules block the agent reads and copies the desk briefs. The runner takes design for social cards, with the same loop, proof and dashboard, and desks return files rather than editing the repo. The other commands are Claude Code only for now. The installer is tested for each of these agents, and jobs have completed through the Claude, Codex and Antigravity CLIs. |
|---|
@@ -992,55 +394,49 @@ ${bots.defs}
Models per role.
API keys are the fallback. One provider is fine, and tiers can mix. Jobs have completed through the Anthropic, OpenAI and Google CLIs. Google uses Antigravity CLI.
- {
+ {
"models": {
"director": "anthropic/opus",
"senior": "anthropic/sonnet",
"builder": "openai/nano"
}
}
- Set once in .desk/project.json, or from the dashboard for one job.
+ Set once in .desk/project.json, or from the dashboard for one job.
-
-
-
-
OPEN SOURCE
-
Make your first contribution.
-
-
-
${jobCount} jobs are open. The four small ones name the files to read and the check to run, and none of the checks need a model call. The two new desks are bigger.
-
-
-
Check that a job is open and unclaimed, then comment with what you plan to change. A failed install helps too, report it with the host, version and exact command. Remove private project content from logs.
+
Make your first contribution.
+
${jobCount} jobs are open. The four small ones name the files to read and the check to run, and none of the checks need a model call. The two new desks are bigger.
+
+
+
Check that a job is open and unclaimed, then comment with what you plan to change. A failed install helps too, report it with the host, version and exact command. Remove private project content from logs.
-
GET STARTED
From install to the dashboard.
-
- - 1
Install
In Claude Code:
${cmd(INSTALL)}
In Codex, Cursor, Gemini CLI, Copilot, Windsurf or OpenCode, in the project:
${cmd('npx deskstudio add')}
- - 2
Run a first job
Ask for something. In the other agents, plain words work too.
${cmd('/desk:design a launch card for LinkedIn')}
The files land in .desk/out/<job>/, with a note on who did what, the scores and the cost.
- - 3
Open the dashboard
Once per project, then open the link it prints. Keep it open while the job runs.
${cmd('/desk:dashboard setup')}
${cmd('/desk:dashboard start')}
Outside Claude Code: npx --package deskstudio desk-dashboard setup, then start. How to read it is in the dashboard guide.
+
+ - 1
Install
In Claude Code:
${cmd(INSTALL)}
In Codex, Cursor, Gemini CLI, Copilot, Windsurf or OpenCode, in the project:
${cmd('npx deskstudio add')}
+ - 2
Run a first job
Ask for something. In the other agents, plain words work too.
${cmd('/desk:design a launch card for LinkedIn')}
The files land in .desk/out/<job>/, with a note on who did what, the scores and the cost.
+ - 3
Open the dashboard
Once per project, then open the link it prints. Keep it open while the job runs.
${cmd('/desk:dashboard setup')}
${cmd('/desk:dashboard start')}
Outside Claude Code: npx --package deskstudio desk-dashboard setup, then start. How to read it is in the dashboard guide.
All of it, with older Claude Code versions and the runner, is in the install guide.
+
Every agent, step by step.
Claude Code, one line.
-
${cmd(INSTALL)}
-
On a Claude Code older than 2.1.275: /plugin marketplace add adityareddy-dev/deskstudio, then /plugin install desk@deskstudio.
+
${cmd(INSTALL)}
+
On a Claude Code older than 2.1.275: /plugin marketplace add adityareddy-dev/deskstudio, then /plugin install desk@deskstudio.
Then ask for something.
-
${cmd('/desk:design a launch card for LinkedIn')}
+
${cmd('/desk:design a launch card for LinkedIn')}
Other agents, one line in the project.
Codex, Cursor, Gemini CLI, Copilot, Windsurf or OpenCode: one line in the project.
-
${cmd('npx deskstudio add')}
-
It writes .desk/, copies the desks to .agents/skills/desk/ and puts one marked block in the agent's instruction file. Every agent by default, one with --agent codex. Run it again any time, it only touches what sits between its markers.
+
${cmd('npx deskstudio add')}
+
It writes .desk/, copies the desks to .agents/skills/desk/ and puts one marked block in the agent's instruction file. Every agent by default, one with --agent codex. Run it again any time, it only touches what sits between its markers.
Then ask the agent in plain words, it reads the block and runs the studio.
-
${cmd('design a launch card for LinkedIn')}
-
Or run it yourself: npx --package deskstudio desk-run design "a launch card for LinkedIn". The desks call models through the CLI you are already signed in to (claude, codex or agy) or a key (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY). npx --package deskstudio desk-run doctor shows which path it will take without making a model call. Files land in .desk/out/<job>/ either way.
+
${cmd('design a launch card for LinkedIn')}
+
Or run it yourself: npx --package deskstudio desk-run design "a launch card for LinkedIn". The desks call models through the CLI you are already signed in to (claude, codex or agy) or a key (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY). npx --package deskstudio desk-run doctor shows which path it will take without making a model call. Files land in .desk/out/<job>/ either way.
-
-
-
-
GOOD QUESTIONS
-
FAQ.
-
-
-
-
Do I need another account?
-
Open source, MIT. No account, no sign-up.
-
-
-
What leaves my machine?
-
Only the model calls the desks make and a few research lookups. Jobs, renders, scores and the brand file stay in your project folder.
-
-
-
What does the score mean?
-
Scores come from the studio's model reviewers, they are not independent benchmarks.
-
-
-
Can I choose the rough?
-
Yes. From the dashboard, pick a rough yourself, over the Art Director.
-
-
Does it cost anything?
Nothing. It is MIT and free. The desks call models through the CLI you already have signed in or a key you set, so the only cost is the model calls you already pay for.
-
Which agents does it work in?
Claude Code as a plugin, with the desks as native subagents. Codex, Cursor, Gemini CLI, Copilot, Windsurf and OpenCode through npx deskstudio add, which writes one rules block the agent reads.
-
How do I add a desk?
Copy an existing brief in skills/desk/roles, write the new one in the same shape, add it to skills/desk/desks.json and open a pull request. CONTRIBUTING.md walks through it.
-
Why is it free?
It's MIT and it runs on your machine, so there's no server to pay for. You pay for the model calls you already make, and every piece above shows what it cost. One person maintains it so far, and the open jobs above are listed by name. If a desk, an agent adapter or a check is missing, you can add it.
+
+
+
FAQ.
+
+
Do I need another account?
Open source, MIT. No account, no sign-up.
+
What leaves my machine?
Only the model calls the desks make and a few research lookups. Jobs, renders, scores and the brand file stay in your project folder.
+
What does the score mean?
Scores come from the studio's model reviewers, they are not independent benchmarks.
+
Can I choose the rough?
Yes. From the dashboard, pick a rough yourself, over the Art Director.
+
Does it cost anything?
Nothing. It is MIT and free. The desks call models through the CLI you already have signed in or a key you set, so the only cost is the model calls you already pay for.
+
Which agents does it work in?
Claude Code as a plugin, with the desks as native subagents. Codex, Cursor, Gemini CLI, Copilot, Windsurf and OpenCode through npx deskstudio add, which writes one rules block the agent reads.
+
How do I add a desk?
Copy an existing brief in skills/desk/roles, write the new one in the same shape, add it to skills/desk/desks.json and open a pull request. CONTRIBUTING.md walks through it.
+
Why is it free?
It's MIT and it runs on your machine, so there's no server to pay for. You pay for the model calls you already make, and every piece above shows what it cost. One person maintains it so far, and the open jobs above are listed by name. If a desk, an agent adapter or a check is missing, you can add it.
-