---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.4
  - property: og:type
    content: article
  - property: article:section
    content: Integration with other services
  - property: og:title
    content: Tracker CLI
  - property: article:tag
    content: Technical instruction
alternate:
  - https://yandex.ru/support/tracker/en/user/cli.md
  - https://yandex.ru/support/tracker/ru/user/cli.md
  - href: https://yandex.ru/support/tracker/en/user/cli.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/support/tracker/en/llms.txt
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/en/llms.txt


# Tracker CLI

Use the `ytracker` CLI to work with Tracker issues from the terminal.

## Installing the CLI and signing in to Tracker {#install-cli}

`ytracker` is a command-line utility for working with Tracker. It lets you create and open issues, read comments, attachments, and checklists, change issue statuses, and search for issues from the terminal. The utility works without Node.js or npm.

To install the CLI on macOS or glibc-based Linux, run:

```bash
curl -fsSL https://storage.yandexcloud.net/ytracker-cli/install.sh | sh
ytracker --version --json
```

To install the CLI on Windows x64, run the following command in PowerShell:

```powershell
irm https://storage.yandexcloud.net/ytracker-cli/install.ps1 | iex
ytracker --version --json
```

The installer verifies the checksum of the downloaded file. On macOS and Linux, the command is installed in your home directory. On Windows, it is added to your user `Path` variable.

To sign in, you need your organization ID. Copy it from [**Administration → Organizations**](https://tracker.yandex.com/admin/orgs).

Run the following command and confirm the sign-in on the page opened by the utility:

```bash
ytracker auth login --method browser --organization-id <organization_id>
```

To check the authentication, run:

```bash
ytracker whoami --json
```

## Working with issues and the API in the CLI {#cli-usage}

You can use the CLI to view, search for, create, and update issues. For example:

- View an issue with its comments, attachments, and checklist: `ytracker TEAM-42`.
- Search for an issue by text: `ytracker issue search --text "login form"`.
- Create an issue: `ytracker issue create --summary "Add validation" --queue TEAM --type task`.
- Update an issue: `ytracker issue update TEAM-42 --priority critical --assignee me`.

To see all commands, run `ytracker --help`. For help with a command group, specify its name, for example, `ytracker issue --help`.

Commands for working with issues can be used for automation and do not prompt for input. When output is redirected, the utility writes valid JSON to standard output and diagnostic messages to standard error.

Before modifying data, add the `--dry-run` parameter to the command. The utility prints the HTTP request plan without sending the requests.

You can store default values for new issues in the `.tracker.toml` file in your repository.

To send a direct request to the Public API, use the `ytracker api` command. For example:

```bash
ytracker api GET issues/TEAM-42
```

The `ytracker api` command uses the same authentication as other commands and returns the API response with its status and headers.

#### See also {#see-also}

- [Tracker MCP server](https://yandex.ru/support/tracker/en/user/mcp-server.md)