---
title: "Run your tests in a box"
description: "Run a project's test suite in an isolated box and read the receipt it prints."
order: 1
verified:
  cli: "0.0.0-mock"
  date: "2026-10-20"
---

Run your tests with `vakna shell <box> -- <command>`: the test runner's output and exit code pass through unchanged, then Vakna prints how long it took.

## How do I run my tests in a box?

```sh
$ vakna shell api -- pnpm test
```

```prints
212 passed, 0 failed
ran pnpm test · exit 0 38.24s
```

The test runner's lines go to stdout and Vakna's line to stderr, so `2>/dev/null` leaves the runner's output alone.

## What did that cost?

```sh
$ vakna receipt api
```

```prints
receipt
sbx_eu1a_8s9t0v1w                                                         mocked
────────────────────────────────────────────────────────────────────────────────
started in  0.34s · from snapshot
ran         pnpm test · exit 0                                            38.24s
wall clock                                                                41.30s
cost                                                                      $0.004
────────────────────────────────────────────────────────────────────────────────
without the snapshot: +8.11s of setup (8.45s per box, measured)
```