
# Desk Studio
A full design studio inside the coding agent you already use. One command, free, nothing leaves your machine but the model calls you already make.
[deskstudio.ai](https://deskstudio.ai) · [Get started](#get-started) · [Dashboard guide](docs/dashboard.md) · [Docs](#docs) · [Contribute](#contribute) · [Discussions](https://github.com/adityareddy-dev/deskstudio/discussions)
[Watch the 50-second explainer](site/media/explainer.mp4)
## Get started
You need Node.js 20 or newer and one model account you already use: Claude Code or the `claude` CLI, the `codex` CLI, Antigravity (`agy`), or an API key (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY` or `GEMINI_API_KEY`).
**In Claude Code**, install the plugin, then ask:
```
/plugin install desk --marketplace adityareddy-dev/deskstudio
/desk:design a launch card for LinkedIn
```
If proof finds no browser on the machine, it prints the one command that sets one up.
**In Codex, Cursor, Gemini CLI, Copilot, Windsurf, OpenCode or a plain terminal**, run these in your project:
```
npx deskstudio add
npx --package deskstudio desk-run doctor
npx --package deskstudio desk-run design "a launch card for LinkedIn"
```
`add` sets the project up and tells your agent about the studio, so after that you can also ask the agent in plain words. `doctor` checks your model sign-in and the browser proof renders with, and makes no model call. `design` makes the card, usually in a few minutes.
No Chrome on the machine? Run this once and proof downloads its own browser:
```
npx --package deskstudio desk-proof setup
```
On a Linux server with no desktop, add `--with-deps` so it also installs the system libraries the browser needs.
The files land in `.desk/out//`: three roughs, `final.html`, and a short note on who did what, the scores and the cost.
## What a run looks like
[Watch the real CLI capture](site/media/real-run.mp4)
The outputs, scores and cost are in [What it makes](docs/gallery.md).
## Watch it work
The dashboard shows the studio as it works. Every desk is a small bot at its own desk, awake while its agent works, and the job moves along a track from the brief to the sign-off with its round, score and cost. Turn it on once per project, start it, and open the link it prints:
```
npx --package deskstudio desk-dashboard setup
npx --package deskstudio desk-dashboard start
```
In Claude Code that is `/desk:dashboard setup`, then `/desk:dashboard start`. It only listens on 127.0.0.1, behind a token in the link.
[Watch a whole job on the dashboard, 50 seconds with captions](site/media/walkthrough.mp4). How to read every part of it is in [the dashboard guide](docs/dashboard.md).
## Why it exists
Cheap models make, strong models judge. Every visual job runs the way a studio runs: roughs, a pick, polish, proof, sign-off. 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. Scores come from the studio's model reviewers, they are not independent benchmarks.
## How it works
Three roughs on Sonnet, the pick on Opus, polish on Haiku, proof with no model, then the sign-off. The launch card job, retold with its real numbers. The five steps, the retry rules and the pixel checks are in [How a job runs](docs/how-it-works.md).
- 42 desks: the Design Manager and 41 that run as subagents. See [the team, cost and models](docs/team-and-cost.md) and [docs/roles.md](docs/roles.md).
- A local [dashboard](docs/dashboard.md) to watch the desks work, pause, move a desk to another model, write a desk a note or pick a rough yourself.
- It runs on your machine. The only things that leave it are the model calls the desks make and, for the few research desks, web lookups. The dashboard is 127.0.0.1 only with a token in the URL. See [docs/privacy.md](docs/privacy.md).
## Settings
`npx deskstudio add` 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`. Outside Claude Code the runner takes `design` for social cards for now. The other commands are Claude Code skills. Older Claude Code versions, the table of instruction files per agent, what each agent gets and the update rules are in [docs/install.md](docs/install.md).
Models are set once in `.desk/project.json`, or from the dashboard for one job:
```json
"models": {
"director": "anthropic/opus",
"senior": "anthropic/sonnet",
"builder": "openai/nano"
}
```
Providers and roles are in [docs/providers.md](docs/providers.md) and [docs/runner.md](docs/runner.md). Proof also works on its own:
```
npx --package deskstudio desk-proof check hero.html --brand .desk/DESIGN.md --sizes phone,desktop
```
## Contribute
Six jobs are open, and none of the checks need a model call. [Your first contribution](docs/first-contribution.md) has the files to read and the check to run for each small one.
- [Cursor setup guide](https://github.com/adityareddy-dev/deskstudio/issues/3) or [Copilot setup guide](https://github.com/adityareddy-dev/deskstudio/issues/4), for someone who uses that host.
- [Safe-zone boundary tests](https://github.com/adityareddy-dev/deskstudio/issues/5) or [required-copy tests](https://github.com/adityareddy-dev/deskstudio/issues/6), for someone comfortable with JavaScript.
- [Localization designer desk](https://github.com/adityareddy-dev/deskstudio/issues/1) or [form designer desk](https://github.com/adityareddy-dev/deskstudio/issues/2), for someone who wants to write a desk. Bigger than the rest.
Check that a job is open and unclaimed before starting. The [contribution guide](CONTRIBUTING.md) covers setup, source files and checks. Want to talk first, or show what you made? [Discussions](https://github.com/adityareddy-dev/deskstudio/discussions) is open, and [Show and tell](https://github.com/adityareddy-dev/deskstudio/discussions/categories/show-and-tell) is for finished pieces. To report a failed install, use the [issue templates](https://github.com/adityareddy-dev/deskstudio/issues/new/choose) with the host, version and exact command. Remove private project content from logs.
## Docs
[Commands](docs/commands.md), [Codex setup](docs/codex.md), [the desks](docs/roles.md), [the dashboard](docs/dashboard.md), [cost](docs/cost.md), [the runner](docs/runner.md), [providers](docs/providers.md), [privacy](docs/privacy.md), [first contribution](docs/first-contribution.md), [install](docs/install.md), [what it makes](docs/gallery.md), [how a job runs](docs/how-it-works.md), [the team, cost and models](docs/team-and-cost.md), [the dashboard in use](docs/dashboard-tour.md).
To cite Desk Studio, use [CITATION.cff](CITATION.cff) or GitHub's **Cite this repository**.
## Licence
MIT.