---
title: make targets
description: What each make target in a venom checkout does, for running the dev stack, building and testing.
section: reference
order: 80
audience: [operator, builder, agent]
sources: [Makefile, devbox.json, scripts/gate.sh, scripts/smoke.sh]
features: [reference.make-checks, reference.make-dev]
---

A venom source checkout is driven by `make`. `make` alone opens the devbox shell with the pinned toolchain; `make help` lists every target with its one-line description. Variables go after the target: `make up SERVICES="orchestrator ollama"`, `make cli ARGS="-p hi"`.

```bash
make env                       # .env from .env.example
make up                        # orchestrator + console in docker
make cli ARGS="doctor"         # venom against that orchestrator
make test                      # every suite: the no-regression gate
make down                      # stop everything this checkout started
```

## Run the stack {#dev}

| Target | What it does |
|---|---|
| `make shell` | Enter the devbox shell (the default target). |
| `make help` | List the targets. |
| `make env` | Create `.env` from `.env.example` if missing. |
| `make up` | Run `make down`, then start `SERVICES` in docker (default: orchestrator and console; `ORCH_TARGET`/`WEB_TARGET=prod` for the production images). Uses a native Ollama when one runs and starts `llmfit serve` when installed. |
| `make up-mac` | macOS: orchestrator and console in docker, Ollama native on the host for the GPU. Fails if Ollama is not up. |
| `make down` | Stop every docker service (all profiles) and this checkout's host-side orchestrator, console, mock, `venom serve` and `llmfit serve`. Volumes are kept. |
| `make restart` | Restart `SERVICES`. |
| `make ps` | Show running services. |
| `make logs` | Tail logs for `SERVICES`. |
| `make build` | Build the docker images for `SERVICES`. |
| `make pull-model` | Pull one Ollama model (`MODEL=qwen3:8b`) into the native Ollama if one runs, else the compose one. |
| `make pull-models` | Pull the models the default routes use (`VENOM_OLLAMA_MODEL`, `VENOM_OLLAMA_FAST_MODEL`). |
| `make model` | Choose, set up and route the local model: a menu, or `BACKEND=ollama\|vllm MODEL=<tag or repo>`. |
| `make model-status` | The local model `.env` selects, what runs, and GPU memory. |
| `make dev-orchestrator` | The orchestrator on the host with hot reload. |
| `make dev-web` | The console on the host (`next dev`, port 3000). |
| `make dev-cli` | Rebuild the CLI on change. |
| `make mock` | A fixture orchestrator on port 8787 for console work. |
| `make cli` | Run venom against the local orchestrator (`ARGS="..."`; `VENOM_CLI_FLAGS` in `.env` adds flags to every run). |
| `make serve` | `venom serve` (needs `VENOM_SERVER_TOKEN`; `ARGS="--root ~/work"`). |
| `make link-cli` | Put `venom` on your `PATH`: a link to the built CLI in npm's global bin dir. |
| `make install` | Install every JavaScript dependency with bun, from each package's `bun.lock` (Go modules are fetched on build). |
| `make clean` | Remove build output. |

## Build {#build}

| Target | Output |
|---|---|
| `make build-orchestrator` | The orchestrator binary in `services/go-orchestrator/bin/`. |
| `make build-web` | A production build of the console. |
| `make build-harness` | The harness library in `packages/harness/dist/`. |
| `make build-server` | The harness server in `packages/harness-server/dist/`. |
| `make build-acp` | The ACP agent in `packages/acp/dist/`. |
| `make build-cli` | The CLI in `cli/dist/`. |
| `make build-python-client` | The `venom-client` sdist and wheel in `clients/python/dist/`. |

## Test and check {#checks}

| Target | What it runs |
|---|---|
| `make test` | Every suite below that needs no network or model: the gate before any pull request. |
| `make test-orchestrator` | Go tests with the race detector. |
| `make test-harness` | Harness type check and unit tests (permissions, compatibility, subagents). |
| `make test-server` | Harness server type check, unit and integration tests with a fake model. |
| `make test-acp` | ACP agent tests with a scripted ACP client over stdio. |
| `make test-charts` | The charts plugin: type check, lint, unit and golden tests. |
| `make test-cli` | CLI type check and unit tests (rebuilds `dist`). |
| `make test-web` | Console lint, unit tests and build. |
| `make test-cloud` | Venom Cloud: type check, contracts, router, app and console tests, build (including the public docs). |
| `make test-evals` | Eval suite type check, task validation and scoring tests, no model. |
| `make test-python-client` | The Python client against a real `venom serve`; skipped without `python3`. |
| `make test-vllm-sampler` | The `venom-sampler/1` reference against shared vectors; skipped without `python3`. |
| `make test-auto-ontology-mcp` | Opt-in: the vendored auto-ontology-mcp server's own tests, in a venv installed from PyPI; skipped without Python 3.12. |
| `make test-vscode` | The VS Code extension, including a real `venom serve` and the `.vsix`. |
| `make test-chrome` | The browser extension against a fake Chrome; no dependencies. |
| `make test-chrome-e2e` | Opt-in: the extension in a real Chrome, two agents in two windows. |
| `make test-scripts` | The shell-script tests: installers, gate, research keys, docs coverage, release work. |
| `make test-sandbox-linux` | The sandbox escape matrix under real bubblewrap, in a privileged container. |
| `make test-airplane` | The offline-capable suites in a container with `--network none`; any new outbound call fails it. |
| `make lint` | Lint everything. |
| `make coverage` | Coverage floors for the harness and CLI. |
| `make knip` | A dead-code report per project; report only. |
| `make smoke` | The first-run check: quick start in a clean container, compose invariants, a live stack. `STAGES=` picks stages, including opt-in `prod`, `release` and `conformance`. |
| `make conformance` | The official OpenAI Python and Node SDKs against the orchestrator and a fake upstream. |
| `make gate` | The pre-merge gate for a pull request (`PR=<n>`): merge main, then run the stages its paths need. |
| `make backtest` | End-to-end backtest against a live orchestrator. |
| `make backtest-orchestrator` | The live orchestrator API backtest. |
| `make bench` | Orchestrator micro-benchmarks, kept in `dist/bench/`. |
| `make bench-check` | Hot-path benchmarks against a base ref (default `origin/main`); fails on a regression. |
| `make bench-baseline` | Re-record the committed benchmark baseline on an idle machine. |
| `make bench-context` | Compaction over a scripted long session. |
| `make bench-runtime` | Many scripted subagents: throughput, latency, fairness, memory. |
| `make loadtest` | The orchestrator under concurrent streams: added latency, CPU, memory, soak. |
| `make cache-report` | A prompt-cache report over the request log. |
| `make canary-report` | A promote, hold or wait verdict for a model canary from experiment outcomes. |
| `make escapes` | Rank the gates that let reverted or `Fixes-escape:` changes through. |

## Related

- [Environment variables](/docs/reference/environment.md)
- [Architecture, ports and contracts](/docs/reference/architecture.md)
