Let your coding agent hand off whole tasks

Devboxes gives the task its own machine with your code and tools ready, and keeps working after you close the laptop.

Start for free Read the docs

Free for individuals

  • Claude Code
  • Codex
  • GitHub
  • Telegram
  • Discord
✳ Claude Code

add a csv export to the invoices page

Read(src/invoices/routes.ts) Read 84 lines
Read(src/invoices/table.tsx) Read 132 lines

The export needs a new route and a button above the table.

hand this off to devboxes

devboxes - devboxes_invoke (MCP)(command: "sessions.dispatch", input: {"title":"invoice csv export",…}) {"data":{"status":"queued",…}}

The CSV export is running on Devboxes as "invoice csv export".

the chart labels overlap on mobile, take a look

tom/ledger · invoice csv export
  • node 22
  • pnpm
  • postgresql 16

working · pnpm test

The task keeps going after you close the laptop

The box runs the tests and lints, so your laptop stays fast. When the change is ready, the box sleeps and costs nothing until you continue it.

Your laptop closed 19:30

> hand this off to devboxes

The box

pnpm test pnpm lint

21:10 · ready to check asleep · $0

Paste one prompt and your agent sets up Devboxes

Your coding agent works out what your project needs to run and sets up Devboxes to start it the way you do.

tom/ledger
  • node 22
  • pnpm
  • ffmpeg
  • postgresql 16
  • pnpm dev
  • pnpm test
  • pnpm lint

Prompt for your agent

Set up Devboxes for this repository.

  1. Install the Devboxes CLI. Run curl -fsSLO https://devboxes.ai/install, check the file against the SHA-256 checksum published with the latest release at https://github.com/firatoezcan/devboxes-cli/releases, then run sh install.
  2. Ask me how I want to sign in, and suggest GitHub only if this repository's remote is on GitHub. Then run devboxes signup with my choice. Connect my model subscription after that.
  3. Work out what this repository needs to run: its languages, package managers and services such as PostgreSQL. Pick the matching packages from the Devboxes Nixhub catalog, and create a Devboxes Project for this repository with a workspace image that has them.
  4. Write a Blueprint for the Project that installs the dependencies, starts the dev server, runs the tests and runs the other common tasks of this repository. Publish it.
  5. Add the Devboxes MCP server (devboxes mcp) to your settings, so you can hand tasks to Devboxes from here.

Tell me when each step is done.

Automations you set up once keep running

Tell Devboxes once what to do and when, and the box wakes for it.

  • every monday, update dependencies

    Ready to check · Monday

  • every sunday, remove dead code

    Ready to check · Sunday

  • when the build on main breaks, fix it

    Ready to check · Friday

  • fix new bug reports on github

    Ready to check · today

box asleep box woke · change ready to check

Your agents and your CI start work without you

Give an agent or a CI job a delegation token with fine-grained permissions, and it starts tasks on Devboxes with only the access you granted.

Deploy #214

tom/ledger · main · pushed 12 minutes ago

deploy.yml on: push

  1. build 1m 4s
  2. deploy 38s
  3. smoke-test 22s
  4. devboxes 5s

Annotations 1 notice

devboxes Handed the failing smoke test to Devboxes.

Prompt for your agent

Hand failing smoke tests in this repository to Devboxes.

  1. Add a devboxes job to deploy.yml that runs when the smoke test fails.
  2. In that job, hand the failure to Devboxes as a task.
  3. Create a Devboxes delegation token that can only start tasks.
  4. Save it as the DEVBOXES_TOKEN secret of this GitHub repository.

Changes come back the way you like them

Tell Devboxes how you like things done, and later changes follow it.

  1. You said on Sep 3 use date-fns for dates

    src/export/csv.ts
    import { format } from "date-fns";
date: format(invoice.sentAt, "yyyy-MM-dd"),

  2. You said on Sep 12 add a test with every change

    src/export/csv.test.ts
    test("one row per invoice", () => {
  expect(rows(invoices)).toHaveLength(3);
});

  3. You said on Sep 20 commit messages in plain english

    git log
    b72e1f4 Add a CSV export to the invoices page

Start for free with just three commands

Free for individuals within fair use, on our servers in Germany or on your own machine.

Read the docs
Read the source
curl -fsSLO https://devboxes.ai/install shasum -a 256 -c <<< "35f4c98f35cbb7b1e1773ea523acccf0e4c5472d297195e0fe01dd965910ba32 install" && sh install devboxes signup