Tracker CLI
Use the ytracker CLI to work with Tracker issues from the terminal.
Installing the CLI and signing in to Tracker
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:
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:
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.
Run the following command and confirm the sign-in on the page opened by the utility:
ytracker auth login --method browser --organization-id <organization_id>
To check the authentication, run:
ytracker whoami --json
Working with issues and the API in the CLI
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:
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.