Sprint CLI

CLI nastroj pro Sprint task manager. Funguje podobne jako AWS CLI -- konfiguracni soubor, API klic, jednoduche prikazy.

Instalace

# 1. Stahni repo (pokud jeste nemas)
git clone [email protected]:TAPP-STUDIO/sprint-web.git
cd sprint-web/cli

# 2. Nainstaluj zavislosti a zbuilduj
npm install
npm run build

# 3. (Volitelne) Zpristupni globalne
sudo npm link

Pokud nechces pouzivat sudo npm link, muzes CLI spoustet primo:

node /cesta/ke/sprint-web/cli/dist/index.js <prikaz>

Konfigurace

Ziskani API klice

API klic ti vytvori admin (VB). Klic zacina sk_live_... a zobrazi se jen jednou -- uloz si ho.

Nastaveni

sprint configure

Zada se:

• API URL: https://sprint-task.com
• API Key: tvuj sk_live_... klic
• Output format: json (doporuceno) nebo table

Konfigurace se ulozi do ~/.sprint/config.json a ~/.sprint/credentials.

Environment variables (alternativa)

Misto konfiguracniho souboru lze pouzit env variables:

export SPRINT_API_KEY="sk_live_..."
export SPRINT_API_URL="https://sprint-task.com"
export SPRINT_OUTPUT="json"

Prikazy

Cteni (bez potvrzeni)

sprint whoami                                    # kdo jsem, jaka organizace
sprint spaces list                               # vsechny spaces
sprint projects list -s <spaceId>                # projekty ve space
sprint tasks list -p <projectId>                 # tasky v projektu
sprint tasks list -p <id> --status todo,in_progress  # filtr na status
sprint tasks list -p <id> --priority high,urgent     # filtr na prioritu
sprint tasks get <taskId>                        # detail tasku
sprint subtasks list -t <taskId>                 # subtasky tasku
sprint members list                              # clenove organizace
sprint labels list                               # labely organizace

Zapis (s potvrzenim)

# Vytvoreni tasku
sprint tasks create -p <projectId> -s <spaceId> --title "Nazev" \
  --status todo --priority medium

# Aktualizace tasku
sprint tasks update <taskId> --status done
sprint tasks update <taskId> --title "Novy nazev" --priority high

# Smazani tasku
sprint tasks delete <taskId>

# Subtasky
sprint subtasks create -t <taskId> --title "Nazev subtasku"
sprint subtasks update -t <taskId> --subtask-id <subtaskId> --completed true

Uzitecne flagy

| Flag | Popis | |---|---| | -y, --yes | Preskocit potvrzovaci dialog | | --dry-run | Zobrazit co by se stalo, ale neprovest | | -o, --output <format> | json (default) nebo table |

Pouziti s Claude Code

Pokud pouzivas Claude Code, pridej do sveho ~/.claude/CLAUDE.md:

## Sprint CLI
- Na zacatku prace si nacti tasky: `sprint tasks list -p <projectId>`
- Cteni (list, get) muzes kdykoli bez ptani
- Zapis (create, update, delete) VZDY se zeptej uzivatele pred provedenim
- CLI cesta: node /cesta/ke/sprint-web/cli/dist/index.js

Bezpecnost

• API klice jsou hashovane (SHA-256) v databazi
• ~/.sprint/credentials ma prava 600 (jen vlastnik)
• Scope read -- klic muze jen cist, read_write -- muze i zapisovat
• Sprava klicu (vytvoreni, revokace) je mozna jen pres webove rozhrani