> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> Every public toloka command, argument, and option.

Browse the commands below, or follow the [CLI guide](https://docs.platform.toloka.ai/docs/cli.md) to install, sign in, and complete a workflow.

```bash theme={null}
toloka [options] [command]
```

## Help

Use `toloka help [command]` to print help for the CLI or a top-level command. For any command, append `-h` or `--help`, for example `toloka dataset fields add --help`.

## Commands

| Command | Summary |
| - | - |
| [`toloka version`](https://docs.platform.toloka.ai/docs/cli/reference/version) | Print the current CLI version. |
| [`toloka config`](https://docs.platform.toloka.ai/docs/cli/reference/config) | Read and write machine CLI settings. |
| [`toloka config get`](https://docs.platform.toloka.ai/docs/cli/reference/config/get) | Print a CLI setting, or every setting. |
| [`toloka config set`](https://docs.platform.toloka.ai/docs/cli/reference/config/set) | Write a CLI setting for this machine. |
| [`toloka login`](https://docs.platform.toloka.ai/docs/cli/reference/login) | Sign in through your browser, or store an API key, after verifying access. |
| [`toloka logout`](https://docs.platform.toloka.ai/docs/cli/reference/logout) | Remove stored credentials from this machine and end the browser login. |
| [`toloka auth-status`](https://docs.platform.toloka.ai/docs/cli/reference/auth-status) | Show which platform and credential the CLI would use. |
| [`toloka project`](https://docs.platform.toloka.ai/docs/cli/reference/project) | Select and manage the current platform project. |
| [`toloka project list`](https://docs.platform.toloka.ai/docs/cli/reference/project/list) | List remote projects this key can see. |
| [`toloka project add`](https://docs.platform.toloka.ai/docs/cli/reference/project/add) | Register a live project and select it. |
| [`toloka project switch`](https://docs.platform.toloka.ai/docs/cli/reference/project/switch) | Select a registered project. |
| [`toloka project current`](https://docs.platform.toloka.ai/docs/cli/reference/project/current) | Show the project this command would use. |
| [`toloka project url`](https://docs.platform.toloka.ai/docs/cli/reference/project/url) | Print the current project URL. |
| [`toloka project remove`](https://docs.platform.toloka.ai/docs/cli/reference/project/remove) | Forget a local project alias. |
| [`toloka project untrack`](https://docs.platform.toloka.ai/docs/cli/reference/project/untrack) | Remove a pipeline or dataset from local tracking without deleting it. |
| [`toloka project token`](https://docs.platform.toloka.ai/docs/cli/reference/project/token) | Mint a project-scoped token for agents and scripts; printed once, never stored. |
| [`toloka project tokens`](https://docs.platform.toloka.ai/docs/cli/reference/project/tokens) | List live project-scoped tokens. |
| [`toloka project revoke-token`](https://docs.platform.toloka.ai/docs/cli/reference/project/revoke-token) | Revoke a project-scoped token; it stops working immediately. |
| [`toloka project revoke-tokens`](https://docs.platform.toloka.ai/docs/cli/reference/project/revoke-tokens) | Revoke every live project-scoped token of the project; they stop working immediately. |
| [`toloka project create`](https://docs.platform.toloka.ai/docs/cli/reference/project/create) | Create a live project and select it. |
| [`toloka audience`](https://docs.platform.toloka.ai/docs/cli/reference/audience) | Inspect the expert audience catalog used by node audience filters. |
| [`toloka audience specialization`](https://docs.platform.toloka.ai/docs/cli/reference/audience/specialization) | Expert specializations (platform qualifications). |
| [`toloka audience specialization list`](https://docs.platform.toloka.ai/docs/cli/reference/audience/specialization/list) | List specializations with their id, name, and expert count. |
| [`toloka generation-model`](https://docs.platform.toloka.ai/docs/cli/reference/generation-model) | Inspect the models synthetic generation nodes can use. |
| [`toloka generation-model list`](https://docs.platform.toloka.ai/docs/cli/reference/generation-model/list) | List generation models with reasoning efforts and maxCostPerAttempt bounds. |
| [`toloka init`](https://docs.platform.toloka.ai/docs/cli/reference/init) | Initialize this project directory and install the agent bootstrap. |
| [`toloka import`](https://docs.platform.toloka.ai/docs/cli/reference/import) | Generate TypeScript source from a live project. |
| [`toloka plan`](https://docs.platform.toloka.ai/docs/cli/reference/plan) | Show what apply would change. |
| [`toloka validate`](https://docs.platform.toloka.ai/docs/cli/reference/validate) | Run platform spec validation and report matching checks. |
| [`toloka check`](https://docs.platform.toloka.ai/docs/cli/reference/check) | Run the complete local source, type, and test gate. |
| [`toloka apply`](https://docs.platform.toloka.ai/docs/cli/reference/apply) | Check source, then make the platform match it. |
| [`toloka secret`](https://docs.platform.toloka.ai/docs/cli/reference/secret) | Manage project secrets. |
| [`toloka secret set`](https://docs.platform.toloka.ai/docs/cli/reference/secret/set) | Set a secret value without writing it to disk. |
| [`toloka expert-list`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list) | Manage the project's expert lists, which nodes with audienceMode service take experts from. |
| [`toloka expert-list list`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/list) | List the project's expert lists. |
| [`toloka expert-list create`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/create) | Create an empty expert list. |
| [`toloka expert-list show`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/show) | Show a list and how many of its experts are available. |
| [`toloka expert-list rename`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/rename) | Rename a list. |
| [`toloka expert-list hide`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/hide) | Hide a list: its experts can't be added or removed until it is shown again; nodes that use it keep working. |
| [`toloka expert-list unhide`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/unhide) | Show a hidden list again. |
| [`toloka expert-list experts`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/experts) | List a page of the list's experts with their status. |
| [`toloka expert-list add`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/add) | Add experts to a list, from arguments or a file. |
| [`toloka expert-list remove`](https://docs.platform.toloka.ai/docs/cli/reference/expert-list/remove) | Remove experts from a list. |
| [`toloka expert-ban-list`](https://docs.platform.toloka.ai/docs/cli/reference/expert-ban-list) | Manage the project's expert ban list: banned experts can't work on the project. |
| [`toloka expert-ban-list show`](https://docs.platform.toloka.ai/docs/cli/reference/expert-ban-list/show) | Show how many experts are banned and in which status. |
| [`toloka expert-ban-list experts`](https://docs.platform.toloka.ai/docs/cli/reference/expert-ban-list/experts) | List a page of the banned experts with their status. |
| [`toloka expert-ban-list add`](https://docs.platform.toloka.ai/docs/cli/reference/expert-ban-list/add) | Ban experts: they can't be invited and are removed from the work they're in. |
| [`toloka expert-ban-list remove`](https://docs.platform.toloka.ai/docs/cli/reference/expert-ban-list/remove) | Lift the bans of experts. |
| [`toloka base-model`](https://docs.platform.toloka.ai/docs/cli/reference/base-model) | Inspect the global base model catalog. |
| [`toloka base-model list`](https://docs.platform.toloka.ai/docs/cli/reference/base-model/list) | List base models. |
| [`toloka base-model get`](https://docs.platform.toloka.ai/docs/cli/reference/base-model/get) | Show one base model. |
| [`toloka model`](https://docs.platform.toloka.ai/docs/cli/reference/model) | Manage project Models and immutable versions. |
| [`toloka model list`](https://docs.platform.toloka.ai/docs/cli/reference/model/list) | List up to 100 Models owned by the selected project (first page only). |
| [`toloka model get`](https://docs.platform.toloka.ai/docs/cli/reference/model/get) | Show one project Model. |
| [`toloka model versions`](https://docs.platform.toloka.ai/docs/cli/reference/model/versions) | List immutable versions of a model. |
| [`toloka model create`](https://docs.platform.toloka.ai/docs/cli/reference/model/create) | Create project Model metadata without a Model Version. |
| [`toloka model archive`](https://docs.platform.toloka.ai/docs/cli/reference/model/archive) | Archive a project Model. |
| [`toloka model version`](https://docs.platform.toloka.ai/docs/cli/reference/model/version) | Manage one immutable Model Version. |
| [`toloka model version download`](https://docs.platform.toloka.ai/docs/cli/reference/model/version/download) | Download and verify Model Version content. |
| [`toloka training`](https://docs.platform.toloka.ai/docs/cli/reference/training) | Manage project Training drafts. |
| [`toloka training list`](https://docs.platform.toloka.ai/docs/cli/reference/training/list) | List up to 100 active Trainings owned by the selected project (first page only). |
| [`toloka training get`](https://docs.platform.toloka.ai/docs/cli/reference/training/get) | Show one Training draft. |
| [`toloka training create`](https://docs.platform.toloka.ai/docs/cli/reference/training/create) | Create a Training draft. |
| [`toloka training update`](https://docs.platform.toloka.ai/docs/cli/reference/training/update) | Update a Training draft. Omitted hyperparameters keep their current values. |
| [`toloka training cost`](https://docs.platform.toloka.ai/docs/cli/reference/training/cost) | Validate Training inputs and calculate the maximum charge. |
| [`toloka training run`](https://docs.platform.toloka.ai/docs/cli/reference/training/run) | Calculate a ready Cost Estimate and create one queued Training Run. |
| [`toloka training runs`](https://docs.platform.toloka.ai/docs/cli/reference/training/runs) | List up to 100 Training Runs (first page only). |
| [`toloka training status`](https://docs.platform.toloka.ai/docs/cli/reference/training/status) | Show one Training Run. |
| [`toloka training resume`](https://docs.platform.toloka.ai/docs/cli/reference/training/resume) | Resume a Training Run blocked on funds or payment. |
| [`toloka training cancel`](https://docs.platform.toloka.ai/docs/cli/reference/training/cancel) | Cancel a Training Run before training completes. |
| [`toloka training metrics`](https://docs.platform.toloka.ai/docs/cli/reference/training/metrics) | Read Training Run metrics. |
| [`toloka training logs`](https://docs.platform.toloka.ai/docs/cli/reference/training/logs) | Read sanitized Training Run logs. |
| [`toloka batch-inference`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference) | Answer dataset rows with a base model or Model Version. |
| [`toloka batch-inference run`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference/run) | Quote a Batch Inference Run, then confirm it to start. |
| [`toloka batch-inference list`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference/list) | List up to 100 of the selected project's Batch Inference Runs (first page only). |
| [`toloka batch-inference status`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference/status) | Show one Batch Inference Run. |
| [`toloka batch-inference confirm`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference/confirm) | Accept the quoted maximum charge and start the run. |
| [`toloka batch-inference resume`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference/resume) | Resume a run blocked on funds or payment. |
| [`toloka batch-inference cancel`](https://docs.platform.toloka.ai/docs/cli/reference/batch-inference/cancel) | Cancel a run; answers already generated are kept and the GPU time used is charged. |
| [`toloka dataset`](https://docs.platform.toloka.ai/docs/cli/reference/dataset) | Inspect and move dataset catalog and rows. |
| [`toloka dataset list`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/list) | List live datasets in the selected project. |
| [`toloka dataset create`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/create) | Create an empty dataset in the selected project. |
| [`toloka dataset fields`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/fields) | Print field declarations inferred from uploaded rows, or add dataset fields from them. |
| [`toloka dataset fields declarations`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/fields/declarations) | Print field declarations inferred from uploaded rows. |
| [`toloka dataset fields add`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/fields/add) | Add dataset fields from fields of the uploaded rows, so filters, `--balance-by` and split columns can use their values; uploads after this fill them too. |
| [`toloka dataset load`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/load) | Download live dataset rows into a JSONL file, one object of the chosen fields per row. |
| [`toloka dataset upload`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/upload) | Append rows to a dataset. |
| [`toloka dataset slice`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/slice) | Freeze the rows of a dataset, with chosen columns read as they were then. |
| [`toloka dataset slice create`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/slice/create) | Freeze the rows that match a filter, or every row, so the same slice always selects the same rows. |
| [`toloka dataset slice list`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/slice/list) | List up to 100 slices of a dataset, newest first (first page only). |
| [`toloka dataset slice show`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/slice/show) | Show the status, filter, frozen columns and row count of a slice. |
| [`toloka dataset split`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/split) | Put every row without a part in one, sampled by share; rows that already have a part keep it, so test rows stay test as the dataset grows. |
| [`toloka dataset columns`](https://docs.platform.toloka.ai/docs/cli/reference/dataset/columns) | List the columns of a dataset, with the parts and roles of split columns. |
| [`toloka pipeline`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline) | Operate on a live pipeline in the selected project. |
| [`toloka pipeline list`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/list) | List live pipelines in the selected project. |
| [`toloka pipeline run`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/run) | Start a run on an applied pipeline. |
| [`toloka pipeline lint`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/lint) | Run the pipeline's lints that have no current result. |
| [`toloka pipeline status`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/status) | Report the latest run's state and item counts. |
| [`toloka pipeline runs`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/runs) | List recent runs. |
| [`toloka pipeline cost`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/cost) | Forecast what a run of this pipeline would bill. |
| [`toloka pipeline cancel`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/cancel) | Request cancellation of a run. |
| [`toloka pipeline results`](https://docs.platform.toloka.ai/docs/cli/reference/pipeline/results) | Report a run's items. |
| [`toloka status`](https://docs.platform.toloka.ai/docs/cli/reference/status) | Report project health: live counts and pending source changes. |
| [`toloka report`](https://docs.platform.toloka.ai/docs/cli/reference/report) | Preview and send an issue report to Toloka. |
| [`toloka skill`](https://docs.platform.toloka.ai/docs/cli/reference/skill) | Discover bundled agent skills and install them into .agents/skills. |
| [`toloka skill list`](https://docs.platform.toloka.ai/docs/cli/reference/skill/list) | List bundled skills as not-installed, current, or stale. |
| [`toloka skill search`](https://docs.platform.toloka.ai/docs/cli/reference/skill/search) | Find bundled skills for a task. |
| [`toloka skill install`](https://docs.platform.toloka.ai/docs/cli/reference/skill/install) | Copy one bundled skill into .agents/skills/\<skillId>. |
| [`toloka ui`](https://docs.platform.toloka.ai/docs/cli/reference/ui) | Inspect components available for labeling interfaces. |
| [`toloka ui components`](https://docs.platform.toloka.ai/docs/cli/reference/ui/components) | List Task UI components, or print the props, value shape, and example of the named ones. |

## Global options

**-v, --version** `boolean`

Output the current version.

**--source-root \<directory>** `string`

Project root; otherwise search the working directory and parents; init and report use only the working directory.

**--api-key \<key>** `string`

API key override; login stores the key it verifies.

Environment fallback: [`TOLOKA_SCOPED_TOKEN`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables), [`TOLOKA_API_KEY`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables).

**--base-url \<url>** `string`

Platform base URL override; login saves the selected URL.

Environment fallback: [`TOLOKA_BASE_URL`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables).

**--project-id \<id>** `string`

Target project; overrides toloka.json.

Environment fallback: [`TOLOKA_PROJECT_ID`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables).

## Additional help

```text theme={null}
Credentials resolve in this order, highest first:
  1. --api-key
  2. TOLOKA_SCOPED_TOKEN
  3. TOLOKA_API_KEY
  4. the API key stored by toloka login --api-key-stdin
  5. the browser login stored by toloka login
The platform defaults to https://platform.toloka.ai.
```

## Environment variables

Client settings read by the CLI are listed below. A variable named with `secret set --from-env` supplies that secret's value. Installer variables are described in [Install](https://docs.platform.toloka.ai/docs/cli.md#install).

**TOLOKA\_SCOPED\_TOKEN** `string`

Project-scoped token. Takes precedence over TOLOKA\_API\_KEY; `--api-key` takes precedence over both.

**TOLOKA\_API\_KEY** `string`

API key used when no `--api-key` or TOLOKA\_SCOPED\_TOKEN is set; takes precedence over saved credentials.

**TOLOKA\_BASE\_URL** `string`

Platform URL. `--base-url` takes precedence; otherwise this overrides the saved URL. The public default is [https://platform.toloka.ai](https://platform.toloka.ai).

**TOLOKA\_PROJECT\_ID** `string`

Project ID. `--project-id` takes precedence; otherwise this overrides toloka.json and the saved project selection.

**TOLOKA\_CREDENTIALS\_FILE** `string`

Credentials JSON file. Defaults to \$XDG\_CONFIG\_HOME/toloka/credentials.json, or \~/.config/toloka/credentials.json.

**TOLOKA\_CLI\_CREDENTIALS\_DIR** `string`

Browser-session directory. Defaults to \~/.toloka/cli/credentials, or browser-sessions beside TOLOKA\_CREDENTIALS\_FILE when that file is set.

**XDG\_CONFIG\_HOME** `string`

Base directory for the default credentials file. Defaults to \~/.config.

**HOME** `string`

Home directory used for credential and browser-session paths. Defaults to the operating system's home directory.

**BROWSER** `string`

Executable used to open the sign-in URL. The URL is passed as its argument. Defaults to the operating system's browser launcher.

**TOLOKA\_TELEMETRY** `string`

Set to 0 to disable usage and exception reports, or 1 to enable them. An explicit value takes precedence over DO\_NOT\_TRACK and CI.

**DO\_NOT\_TRACK** `string`

Set to 1 to disable usage and exception reports unless TOLOKA\_TELEMETRY explicitly enables them.

**CI** `string`

Set to 1 to disable usage reports and automatic updates by default. TOLOKA\_TELEMETRY and TOLOKA\_AUTO\_UPDATE can explicitly enable them.

**TOLOKA\_SKIP\_AUTO\_UPDATE** `string`

Set to 1 to skip automatic updates, even when TOLOKA\_AUTO\_UPDATE enables them.

**TOLOKA\_AUTO\_UPDATE** `string`

Set to 0 to disable automatic updates, or 1 to enable them. Otherwise the auto-update machine setting applies outside CI. Release eligibility and command exclusions still apply.

**NO\_COLOR** `string`

Any set value disables terminal colors unless FORCE\_COLOR overrides it.

**TERM** `string`

The value dumb disables terminal colors unless FORCE\_COLOR overrides it.

**FORCE\_COLOR** `string`

Set to 0 to disable colors, or any other value to enable them even when output is piped. Overrides NO\_COLOR and TERM.

**BUN\_INSTALL** `string`

Bun installation directory used by version reporting to identify the install channel. Defaults to \~/.bun.

**PATH** `string`

Executable search path, also forwarded to local check processes.

**POTATO\_API\_KEY** `string`

Deprecated alias of TOLOKA\_API\_KEY. The current name takes precedence; using the alias prints a deprecation warning.

**POTATO\_BASE\_URL** `string`

Deprecated alias of TOLOKA\_BASE\_URL. The current name takes precedence; using the alias prints a deprecation warning.

**POTATO\_PROJECT\_ID** `string`

Deprecated alias of TOLOKA\_PROJECT\_ID. The current name takes precedence; using the alias prints a deprecation warning.

## Exit codes

| Code | Meaning |
| - | - |
| 0 | Command succeeded, or help/version was printed. A successful run start without `--wait` does not mean the run has finished. Successful `training status` and `batch-inference status` calls return 0 even for failed runs, including `batch-inference status --wait`; inspect the returned `status`. |
| 1 | Command or argument error, failed pipeline run or lint, or failed/missing local check. |
| 2 | Waiting for a pipeline run or its lints timed out, or a local check could not complete because its process or tooling failed. |
| 130 | SIGINT interrupted a non-watch check or the check stage of apply. |
| 143 | SIGTERM interrupted a non-watch check or the check stage of apply. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.