---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.4
  - property: og:type
    content: article
  - property: article:section
    content: Интеграция с другими сервисами
  - property: og:title
    content: CLI Трекера
  - property: article:tag
    content: Техническая инструкция
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/ru/user/cli.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/support/tracker/ru/llms.txt
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


# CLI Трекера

Используйте CLI `ytracker`, чтобы работать с задачами Трекера из терминала.

## Установить CLI и войти в Трекер {#install-cli}

`ytracker` — консольная утилита для работы с Трекером. С ее помощью можно создавать и открывать задачи, читать комментарии, вложения и чеклисты, менять статус и искать задачи из терминала. Утилита работает без Node.js и npm.

Чтобы установить CLI Трекера в macOS или Linux с glibc, выполните команду:

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

Чтобы установить CLI Трекера в Windows x64, выполните команду в PowerShell:

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

Установщик проверяет контрольную сумму загруженного файла. В macOS и Linux утилита устанавливается в каталог пользователя. В Windows установщик добавляет каталог утилиты в пользовательскую переменную `Path`.

Для входа понадобится идентификатор организации. Его можно скопировать на странице [**Администрирование → Организации**](https://tracker.yandex.ru/admin/orgs).

Выполните команду и подтвердите вход на странице, которую откроет утилита:

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

Чтобы проверить авторизацию, выполните команду:

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

## Работать с задачами и API в CLI {#cli-usage}

С помощью CLI можно просматривать, искать, создавать и изменять задачи. Например:

- просмотреть задачу вместе с комментариями, вложениями и чеклистом — `ytracker TEAM-42`;
- найти задачу по тексту — `ytracker issue search --text "форма логина"`;
- создать задачу — `ytracker issue create --summary "Добавить проверку" --queue TEAM --type task`;
- изменить задачу — `ytracker issue update TEAM-42 --priority critical --assignee me`.

Чтобы посмотреть все команды, выполните `ytracker --help`. Для справки по группе команд укажите ее название, например `ytracker issue --help`.

Команды для работы с задачами подходят для автоматизации и не задают интерактивных вопросов. При перенаправлении вывода утилита возвращает валидный JSON в стандартный поток вывода, а диагностические сообщения — в стандартный поток ошибок.

Перед изменением данных добавьте к команде параметр `--dry-run`. Утилита выведет план HTTP-запросов и не отправит их.

Значения по умолчанию для новых задач можно хранить в файле `.tracker.toml` в репозитории.

Чтобы отправить прямой запрос к Public API, используйте команду `ytracker api`. Например:

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

Команда `ytracker api` использует ту же авторизацию, что и другие команды, и возвращает ответ API вместе со статусом и заголовками.

#### Узнайте больше {#see-also}

- [MCP-сервер Трекера](https://yandex.ru/support/tracker/ru/user/mcp-server.md)