poimen-memory/knowledge/tea-cli.md

tea CLI — Gitea/Forgejo Command Line

Setup

# Login to Forgejo instance
tea login add --name riotpiao \
  --url https://git.riotpiao.com \
  --token <your-token>

# Verify
tea whoami

Repository Operations

# List repos
tea repos ls

# Clone
tea clone rock/poimen-memory

# Open in browser
tea open

Issues & Tickets

# List issues
tea issues ls --repo rock/poimen-memory
tea issues ls --state open
tea issues ls --labels bug

# Create issue
tea issues create --title "Fix port conflict" --body "Port 8080 is in use"

# Close issue
tea issues close 42

# Comment on issue
tea comments create 42 --body "Fixed in commit abc123"

# Assign
tea issues edit 42 --assignees rock

Pull Requests

# List PRs
tea pr ls --repo rock/poimen-memory
tea pr ls --state open

# Create PR from current branch
tea pr create --title "feat: add learn command" --base main

# Checkout a PR locally
tea pr checkout 15

# Merge PR
tea pr merge 15 --style squash

# Review PR
tea pr review 15 --approve
tea pr review 15 --request-changes --body "Fix the unwrap()"

CI/CD — Actions & Workflows

# List workflow runs
tea actions runs list --repo rock/poimen-memory
tea actions runs list --repo rock/poimen-memory --limit 5

# View specific run
tea actions runs view <run-id> --repo rock/poimen-memory

# List workflows
tea actions workflows list --repo rock/poimen-memory

# Secrets management
tea actions secrets list --repo rock/poimen-memory
tea actions secrets create --repo rock/poimen-memory --name MY_SECRET --value "secret123"

# Variables
tea actions variables list --repo rock/poimen-memory

Releases

# List releases
tea releases ls --repo rock/poimen-memory

# Create release
tea releases create --repo rock/poimen-memory \
  --tag v1.0.0 \
  --title "v1.0.0 — Production Release" \
  --note "First production release"

Wiki

# List wiki pages
tea wiki ls --repo rock/poimen-memory

# Create wiki page
tea wiki create --repo rock/poimen-memory \
  --title "Setup Guide" \
  --content "# Setup\n..."

API Direct Access

# Raw API call (authenticated)
tea api /repos/rock/poimen-memory
tea api /repos/rock/poimen-memory/issues?state=open

# POST via API
tea api --method POST /repos/rock/poimen-memory/issues \
  --body '{"title":"test","body":"test issue"}'

Ticket Verification Workflow

After completing a task, verify the ticket is done:

# 1. Check CI passed
tea actions runs list --repo rock/poimen-memory --limit 1
# Should show: ✓ completed / success

# 2. Check issue is closed or PR merged
tea issues ls --repo rock/poimen-memory --state closed --limit 5

# 3. Verify the API endpoint works (curl the actual service)
curl -s http://localhost:8080/health | jq .status
# Should return: "ok"

# 4. Tag release if milestone complete
tea releases create --tag v1.x.x --title "Milestone X complete"

Useful Flags

• --repo owner/name — specify repo (or use current git context)
• --output simple — machine-readable output
• --output yaml — YAML format
• --output json — JSON format for piping to jq
• --limit N — limit results
• --state open|closed|all — filter by state
• --fields name,status — select columns