---
title: "vakna status: a task's boxes"
description: "A task's boxes: totals first, then the ones that need you."
command: "vakna status"
generated: scripts/generate.ts
verified:
  cli: "0.0.0-mock"
  date: "2026-10-20"
---

`vakna status`: a task's boxes: totals first, then the ones that need you. Proposed: the real CLI doesn't have this command yet.

## Synopsis

```sh
vakna status [task|box]
```

## Flags

| Flag | Default | What it does |
| -- | -- | -- |
| `--format <format>` | `text` | text, or json: one JSON object per line |
| `--json` | `off` | the same as --format json |
| `-h, --help` | `off` | this help |

## Examples

### Example

```sh
$ vakna status
```

```prints
task prove-hypothesis-42 tsk_eu1a_4x5y6z7a
997 done · 2 stuck · 1 waiting on you · $4.11 so far 3m 12s
  stuck prove-hypothesis-42-0137 · waiting on port 5432 · quiet for 1m 40s
  stuck prove-hypothesis-42-0588 · waiting on port 5432 · quiet for 1m 38s
  waiting on you prove-hypothesis-42-0412 · asks "apply migration 0042? [y/N]"
  … 994 more done
errors: 1 signature (OOM in test runner) ×3
next: vakna attach prove-hypothesis-42-0412  # it is waiting on you
```

Exit code 0.

### Another example

```sh
$ vakna status prove-flaky-retry --format json
```

```prints
{"v":1,"event":"status","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","name":"prove-flaky-retry","mocked":true}
{"v":1,"event":"aggregate","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","done":50,"stuck":0,"waiting":0,"running":false,"costMicros":456944,"ms":131000,"mocked":true}
{"v":1,"event":"more","done":42,"mocked":true}
{"v":1,"event":"errors","task":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","signatures":[{"signature":"e3b0c442","label":"assertion in retry_test.go:88","count":6},{"signature":"9f86d081","label":"timeout after 30s","count":2}],"mocked":true}
{"v":1,"event":"next","command":"vakna receipt prove-flaky-retry","reason":"the failures, grouped","mocked":true}
```

Exit code 0.

### When it fails

```sh
$ vakna status nope
```

```prints
vakna: no box "nope"
hint: vakna list  # it lists your boxes
```

Exit code 1.

## Exit codes

| Code | Meaning |
| -- | -- |
| 0 | ok |
| 1 | vakna failed; under shell, run, try or fork, the command in the box failed |
| 2 | usage: a missing argument, an unknown flag or command |

## JSON output

With `--format json` (or `--json`) every line is one JSON object. `v` is the format's version; `mocked` marks numbers from the mock.

```sh
$ vakna status prove-flaky-retry --format json
```

```prints
{"v":1,"event":"status","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","name":"prove-flaky-retry","mocked":true}
{"v":1,"event":"aggregate","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","done":50,"stuck":0,"waiting":0,"running":false,"costMicros":456944,"ms":131000,"mocked":true}
{"v":1,"event":"more","done":42,"mocked":true}
{"v":1,"event":"errors","task":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","signatures":[{"signature":"e3b0c442","label":"assertion in retry_test.go:88","count":6},{"signature":"9f86d081","label":"timeout after 30s","count":2}],"mocked":true}
{"v":1,"event":"next","command":"vakna receipt prove-flaky-retry","reason":"the failures, grouped","mocked":true}
```

## Errors

- [`vakna: unknown command, unknown flag or missing argument`](https://vakna.com/docs/errors/usage): Run `vakna <command> --help` and fix the command line it points to.
- [`vakna: no box "<box>"`](https://vakna.com/docs/errors/not_found): Run `vakna list` and use a name from it.
- [`vakna: "<id>" matches more than one box`](https://vakna.com/docs/errors/ambiguous): Use the box's name or its full id; `vakna list` shows both.

## --help

This page and the help text come from one definition.

```prints
vakna status · a task's boxes: totals first, then the ones that need you
Proposed: the real CLI doesn't have this command yet.

usage
  vakna status [task|box]

flags
  --format <format>  text, or json: one JSON object per line  (default: text)
  --json             the same as --format json  (default: off)
  -h, --help         this help  (default: off)

examples
  vakna status
  vakna status prove-flaky-retry --format json

exit codes
  0  ok
  1  vakna failed; under shell, run, try or fork, the command in the box failed
  2  usage: a missing argument, an unknown flag or command
```