Canonical: https://dokima.net/docs/commands/
Updated: 2026-11-04T23:30:51+00:00

Documentation

# Command guide

The terminal dashboard is the normal starting point:

```
dokima
```

The commands below are useful for automation, explicit review modes and troubleshooting.

## Manage the licence

```
dokima activate <code>
dokima license status
dokima license refresh
dokima license install <file>
```

Activation stores the signed licence and update credential locally. Free, paid and open-source licences can refresh online; trial dates are fixed at first activation.

## Inspect the workspace

```
dokima repos
dokima repos --sync
dokima config-path
dokima version
```

`repos` lists Git repositories and linked worktrees. `--sync` performs Dokima-owned `git fetch --prune` work.

## Run review work

```
dokima step
dokima stage
dokima sweep
dokima continuous
dokima loop 4h
```

* `step` runs the next due job.
* `stage` drains the next contiguous stage of work.
* `sweep` runs a complete due pass.
* `continuous` keeps running sweeps and waits when the workspace is idle.
* `loop` checks on the interval you provide.

Use `--dry-run` to inspect planned work without invoking an AI runner.

## Choose a review mode

```
dokima sweep --mode architecture
dokima sweep --mode hunting
dokima sweep --mode report
dokima sweep --mode full
```

* `architecture` builds foundation context and verifies assumptions.
* `hunting` plans and runs vulnerability-discovery work.
* `report` performs the bounded Finding Review lifecycle.
* `full` runs the complete review lifecycle.
* `continue` resumes the saved active pass or last run mode.

## Reports and findings

```
dokima report
dokima fix
dokima chat
```

`report` renders accepted finding state. `fix` repairs missing report enrichment. `chat` opens the configured runner with finding and annotation context.

## Update Dokima

```
dokima update
```

The update command uses the credential created during activation to authorise a short-lived release download, verifies its checksum, installs it and refreshes shipped core prompts while preserving your prompt extras. It does not require another form or manual approval while the licence is active.

## When a runner is temporarily limited

Dokima recognises common provider cooldowns, records the window and leaves the current work queued. Long-running commands wait and retry rather than marking that job complete.
