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 |
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 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.
