ytr

module

v0.3.0 Latest Latest Go to latest Published: Jul 26, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/slavkluev/ytr

Links

Open Source Insights

README ¶

ytr

Yandex Tracker CLI for humans and LLM agents.

A command-line client for Yandex Tracker — Yandex's project management tool, similar to Jira. Designed primarily for LLM agents calling commands programmatically, with a strong secondary focus on human developers in the terminal.

Features

Issue management (create, list, view, update, transition, changelog)
Comments, links, worklogs, checklists as sub-resources
Bulk operations (move, update, transition) with async polling
Reference data (statuses, priorities, resolutions, issue types)
Field discovery (global and queue-local fields)
Components and queue management
User lookup and organization listing
Structured JSON output with --json field selection and --jq filtering
Shell completions (bash, zsh, fish)
Designed for LLM agents with predictable output and semantic exit codes

Installation

Homebrew (macOS)

brew install slavkluev/tap/ytr

Go install

go install github.com/slavkluev/ytr@latest

Binary download

Download the latest release from GitHub Releases.

Quick Start

# Authenticate
export YTR_TOKEN="your-oauth-token"
export YTR_ORG_ID="your-org-id"
export YTR_ORG_TYPE="360"  # or "cloud"

# Issue management
ytr issue create --queue PROJ --summary "New task"
ytr issue list --filter queue=PROJ --json key,summary,status
ytr issue transition PROJ-123 --to "In Progress"

# Comments and worklogs
ytr comment create PROJ-123 --body "Working on this"
ytr worklog create PROJ-123 --duration PT2H --start 2026-03-30T10:00:00Z

# Bulk operations
ytr bulk move PROJ-1 PROJ-2 PROJ-3 --queue TARGET
echo "PROJ-1\nPROJ-2" | ytr bulk update --field priority=critical

# Reference data
ytr status list --json key,name
ytr field list --queue PROJ

# JSON output with jq
ytr issue list --filter queue=PROJ --jq '.items[].key'

Authentication

ytr supports three authentication methods (in order of precedence):

Flags: --token, --org-id, and --org-type on any command; provide all three together
Environment variables: YTR_TOKEN, YTR_ORG_ID, and YTR_ORG_TYPE
Config file: ytr auth login saves credentials to ~/.config/ytr/config.yaml

Documentation

Run ytr --help for a list of commands
Run ytr <command> --help for command-specific help
See SKILL.md for LLM agent integration guide

License

MIT — see LICENSE for details.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
ytr command Package main is the entry point for the ytr binary.	Package main is the entry point for the ytr binary.
internal
api
cmd Package cmd provides the root Cobra command and command tree for ytr CLI.	Package cmd provides the root Cobra command and command tree for ytr CLI.
cmd/auth Package auth provides authentication commands for the ytr CLI.	Package auth provides authentication commands for the ytr CLI.
cmd/bulk Package bulk provides bulk change commands for the ytr CLI.	Package bulk provides bulk change commands for the ytr CLI.
cmd/checklist Package checklist provides checklist management commands for the ytr CLI.	Package checklist provides checklist management commands for the ytr CLI.
cmd/comment Package comment provides comment management commands for the ytr CLI.	Package comment provides comment management commands for the ytr CLI.
cmd/completion Package completion provides shell completion script generation for ytr.	Package completion provides shell completion script generation for ytr.
cmd/component Package component provides component management commands for the ytr CLI.	Package component provides component management commands for the ytr CLI.
cmd/field Package field provides field discovery commands for the ytr CLI.	Package field provides field discovery commands for the ytr CLI.
cmd/issue Package issue provides issue management commands for the ytr CLI.	Package issue provides issue management commands for the ytr CLI.
cmd/issuetype Package issuetype provides issue type commands for the ytr CLI.	Package issuetype provides issue type commands for the ytr CLI.
cmd/jsonfields Package jsonfields provides a registry for JSON field completions.	Package jsonfields provides a registry for JSON field completions.
cmd/link Package link provides link management commands for the ytr CLI.	Package link provides link management commands for the ytr CLI.
cmd/priority Package priority provides priority commands for the ytr CLI.	Package priority provides priority commands for the ytr CLI.
cmd/queue Package queue provides queue management commands for the ytr CLI.	Package queue provides queue management commands for the ytr CLI.
cmd/resolution Package resolution provides resolution commands for the ytr CLI.	Package resolution provides resolution commands for the ytr CLI.
cmd/status Package status provides status commands for the ytr CLI.	Package status provides status commands for the ytr CLI.
cmd/user Package user provides user management commands for the ytr CLI.	Package user provides user management commands for the ytr CLI.
cmd/version Package version provides the ytr version command.	Package version provides the ytr version command.
cmd/worklog Package worklog provides worklog management commands for the ytr CLI.	Package worklog provides worklog management commands for the ytr CLI.
config
errors Package errors provides typed errors with semantic exit codes for ytr CLI.	Package errors provides typed errors with semantic exit codes for ytr CLI.
output Package output provides TTY-aware rendering infrastructure for ytr CLI.	Package output provides TTY-aware rendering infrastructure for ytr CLI.
testutil Package testutil provides shared test helpers for ytr command tests.	Package testutil provides shared test helpers for ytr command tests.
validate Package validate provides input validation functions for the ytr CLI.	Package validate provides input validation functions for the ytr CLI.
version Package version provides build-time version information for the ytr binary.	Package version provides build-time version information for the ytr binary.