---
id: cli.reference
title: CLI Command Reference
summary: Find command groups, scope flags, local file inputs, exit codes and recovery rules.
kind: reference
product_area: developer_tools
status: stable
updated: 2026-10-31
canonical: /docs/cli/reference
---

# CLI Command Reference

## Definition

Use `teammately <command> --help` for the flags accepted by that command. The tables below separate reads from local-file operations and submissions.

## Account and agent setup

| Command | Effect |
| --- | --- |
| `login`, `status`, `switch`, `logout` | [Authenticate and select profiles](/docs/cli/authentication) |
| `configure agent-toolkit` | Configure supported agents, skill and local MCP |
| `mcp` | Start read-only product MCP over stdio |
| `update` | Update an installer-managed release; source builds use their build workflow |
| `--version`, `--help` | Inspect the selected binary |

## Read commands

| Command | Key input |
| --- | --- |
| `eval version-context` | `--kind summary`, `cases`, `policies` or `rubrics` |
| `eval manifest` | Selected immutable Version |
| `eval context`, `eval results`, `eval instructions` | `--run` child Trial ID |
| `eval managed-profile` | Current managed execution policy |
| `run get`, `run wait` | `--run` child Trial ID |
| `run compare` | `--run` baseline and `--target` candidate; `--cases` for paged changes |

Context/results support `--limit`, `--offset`, `--result`, `--case`, `--policy` and `--case-rubric-pair`. Pages default to 20 observations, maximum 100. Read output defaults to JSON; `--format human` labels the returned data. Diagnostics use stderr.

## Local files and writes

| Command | Main flags |
| --- | --- |
| `eval prepare` | `--out` new directory |
| `eval validate-results` | `--manifest`, `--results`, optional `--allow-partial` |
| `eval submit-results` | Same files, `--name`, `--receipt`, optional `--group`/`--allow-partial` |
| `eval complete` | `--group`, `--run`, optional `--allow-partial`/`--retry` |
| `harness validate` | `--source` directory |
| `harness submit` | `--source`, `--name`, `--receipt` |
| `harness prepare-runtime` | `--harness`, `--harness-version`, `--receipt` |
| `eval run` | Saved Harness IDs, `--profile-revision`, `--receipt`, optional `--compute-profile` |

The `--profile-revision` flag carries the exact server-issued concurrency token from `eval managed-profile`. Do not choose a value or treat it as a customer-managed configuration lifecycle.

## Fields, states, or lifecycle rules

Global scope uses the [authentication guide's](/docs/cli/authentication) flags/environment. Request timeout defaults to two minutes and can be set with `--timeout` through ten minutes. A timeout stops waiting, not an admitted job.

| Exit code | Meaning |
| --- | --- |
| `0` | Command succeeded; inspect resource state for operational failure |
| `1` | Request, validation or file failure |
| `2` | Invalid command/configuration |
| `3` | Authorization failure |
| `4` | Timeout, cancellation or exhausted transient reads |

Source submission, runtime preparation, managed admission and external-output submission use local recovery receipts. After interruption, reuse original inputs and that stage's receipt. Changed inputs require a new logical operation and receipt. `eval complete` takes no local receipt flag; it uses the server's recorded completion and explicit failed-admission retry contract.

## Related task pages

{% related-card-grid %}
- [External output submission](/docs/cli/external-outputs)
- [Managed Harness](/docs/cli/managed-harness)
- [MCP setup](/docs/cli/mcp)
{% /related-card-grid %}