---
globs:
  - "src/cli/**/*.ts"
  - "src/commands/**/*.ts"
---

# CLI UI Conventions

- **Success:** Green ✓ + concise message + what changed
- **Error:** Red ✗ + what went wrong + how to fix (stack traces only with `--debug`)
- **Warning:** Yellow ⚠ + non-blocking info
- **Info:** Blue → + progress steps
- **Progress:** Use `ora` spinner for ops >2 seconds
- **Help:** `USAGE → OPTIONS → EXAMPLES` format
- **Tables:** Header row + separator line for structured output (status, tasks)
- **Exit codes:** 0=success, 1=error, 2=bad args, 3=state corruption, 4=git error
- **Verbose:** Support `-v`/`--verbose` for debug output