---
title: "Vakna docs"
description: "Every command, concept, recipe and error in Vakna, as HTML and Markdown."
verified:
  cli: "0.0.0-mock"
  date: "2026-10-20"
---

Vakna runs the code AI agents write in boxes: isolated machines you create, suspend, resume and fork from the `vakna` CLI.

These docs are a mockup. No Vakna CLI ships yet: the command and error pages are generated from a mock of it, and every number on these pages (timings, prices, counts) is a placeholder. The shape is real: the pages, their Markdown, search and the agent files are what the docs will be once the real CLI writes them.

[What is Vakna](https://vakna.com/docs/what-is-vakna) says more.

## Install the CLI

One command installs `vakna`.

```sh
$ curl -fsSL https://vakna.com/install.sh | sh
```

## Start with a recipe

Each is a block you can paste, and the receipt it prints.

- [Run your tests in a box](https://vakna.com/docs/recipes/run-tests): Run a project's test suite in an isolated box and read the receipt it prints.
- [Fork a box for a test matrix](https://vakna.com/docs/recipes/fork-a-matrix): Fork one box fifty times from a snapshot and run the same command in each, with one receipt for the lot.
- [Resume yesterday's box](https://vakna.com/docs/recipes/resume-a-box): Resume a suspended box where it stopped, with its processes, memory and ports as they were.

## Every section

The rest of the docs, by what you're looking for.

- [Start](https://vakna.com/docs/start): Install the vakna CLI, sign in, and run your first box.
- [Concepts](https://vakna.com/docs/concepts): What each word in Vakna means, one page per word, from the glossary.
- [Commands](https://vakna.com/docs/commands): Every `vakna` command: its flags with their defaults, examples with what they print, exit codes and JSON.
- [Recipes](https://vakna.com/docs/recipes): The ten things people do with Vakna, each a block you can paste and the receipt it prints.
- [Errors](https://vakna.com/docs/errors): Every error the CLI prints, by its text, each page opening with the fix.
- [API](https://vakna.com/docs/api): Coming with the first release: the API the CLI calls, for code that runs boxes without it; until then, the commands are the reference.
- [Migrations](https://vakna.com/docs/migrations): Coming from E2B, Daytona, Modal, Vercel or Fly Sprites: their call, the `vakna` command for it, and where they do better.
- [Method](https://vakna.com/docs/method): How Vakna's numbers are measured: hardware, region, method and the repo.
- [Changelog](https://vakna.com/docs/changelog): What changed, week by week, one line per change.