yandex-tracker-cli

# Yandex Tracker CLI Skill

Простой CLI для Yandex Tracker на чистом bash + curl. Работает напрямую через API с правильными заголовками (`X-Org-Id`). Не требует внешних зависимостей кроме `curl` и `jq`.

## Установка

1. Скопируйте скрипт в директорию в PATH:
```bash
mkdir -p ~/bin
cp yandex-tracker.sh ~/bin/yandex-tracker
chmod +x ~/bin/yandex-tracker
```

Или создайте симлинк:
```bash
ln -s /path/to/skill/yandex-tracker.sh ~/bin/yandex-tracker
```

2. **Предоставьте credentials**: нужны TOKEN и ORG_ID — либо через переменные окружения, либо через конфигурационный файл (достаточно одного способа). Скрипт обращается к файлу только если TOKEN/ORG_ID не заданы в окружении.

**Вариант A — через переменные окружения (рекомендуется):**
```bash
export TOKEN='y0__...'      # OAuth токен (Tracker UI → Settings → Applications → OAuth)
export ORG_ID='1234...'     # Org ID (DevTools → Network → X-Org-Id)
```
Эти переменные можно добавить в `~/.bashrc` или `~/.profile`.

**Вариант B — через конфигурационный файл:**
Создайте `~/.yandex-tracker-env` (скрипт использует его только если TOKEN/ORG_ID не заданы в окружении). Формат — строки `KEY=value` (комментарии с `#` игнорируются). Файл **читается как текст** (парсятся только TOKEN и ORG_ID), без выполнения кода:
```bash
TOKEN='y0__...'
ORG_ID='1234...'
```
Предпочтительно задавать учётные данные переменными окружения. Если используете файл — установите права `chmod 600 ~/.yandex-tracker-env`.

3. Убедитесь, что `jq` установлен:
```bash
sudo apt install jq   # Ubuntu/Debian
# или
brew install jq       # macOS
```

## Использование

### Основные команды

| Команда | Описание |
|---------|----------|
| `queues` | Список всех очередей (формат: `key<TAB>name`) |
| `queue-get <key>` | Детали очереди (JSON) |
| `queue-fields <key>` | Все поля очереди (включая локальные) |
| `issue-get <issue-id>` | Получить задачу (формат: `BIMLAB-123`) |
| `issue-create <queue> <summary>` | **Создать задачу. Автоматически добавляет тег `yandex-tracker-...

# Yandex Tracker CLI

Консольный клиент для [Яндекс Трекер](https://tracker.yandex.ru/) — работа с очередями, задачами, комментариями, спринтами и чек-листами через API.

## Требования

- **bash** (с поддержкой `BASH_REMATCH`)
- **curl**
- **jq**

## Установка

0. Простейший способ:
   попросить openclaw бота установить yandex-tracker-cli скилл
   или дать ссылку https://clawhub.ai/bkamuz/yandex-tracker-cli

или

1. Скачайте скрипт и сделайте его исполняемым:

   ```bash
   chmod +x yandex-tracker.sh
   ```

2. При желании переименуйте или создайте симлинк для удобства:

   ```bash
   ln -s yandex-tracker.sh yandex-tracker
   ```

## Настройка

Нужны **OAuth-токен** и **Org ID** (идентификатор организации).

- **TOKEN** — получить в Трекере: Настройки → Приложения → OAuth.
- **ORG_ID** — можно посмотреть в DevTools браузера (вкладка Network) в заголовке `X-Org-Id`.

Задать можно двумя способами (приоритет у переменных окружения):

1. **Переменные окружения:**

   ```bash
   export TOKEN="y0_..."
   export ORG_ID="1234567"
   ```

2. **Файл конфигурации** `~/.yandex-tracker-env` (используется, если `TOKEN` и `ORG_ID` не заданы в окружении):

   ```
   TOKEN=y0_...
   ORG_ID=1234567
   ```

   Из файла читаются только строки `TOKEN=...` и `ORG_ID=...` (без выполнения кода).

## Использование

```text
./yandex-tracker.sh <команда> [аргументы]
```

### Очереди

| Команда | Описание |
|--------|----------|
| `queues` | Список очередей |
| `queue-get <key>` | Информация об очереди |
| `queue-fields <key>` | Поля очереди |

### Задачи (issues)

| Команда | Описание |
|--------|----------|
| `issue-get <id>` | Получить задачу |
| `issue-create <queue> <summary>` | Создать задачу (доп. JSON через stdin) |
| `issue-update <id>` | Обновить задачу (JSON через stdin) |
| `issue-delete <id>` | Удалить задачу |
| `issue-transitions <id>` | Доступные переходы по статусам |
| `issue-close <id> <resolution>` | Закрыть задачу с резолюцией |
| `issue-worklog <id> <duration> [comment]`...