prosa-cli-renderinglisted
Install: claude install-skill c3-oss/prosa
# Prosa CLI Rendering
Use this skill before changing CLI command behavior or user-visible
terminal output.
## CLI contract
The public surface lives in `docs/usage.md`. Today it includes:
- `prosa` — renders the local timeline.
- `prosa sync` — scans registered agents, imports sessions, pushes to
the server.
- `prosa search <query>` — searches FTS5 content (local or `--remote`).
- `prosa show <session-id>` — prints preserved raw JSONL.
- `prosa analytics <report>` — one of `sessions | tools | models |
projects | errors`.
- `prosa devices …` — `list | rename | revoke` (cross-device).
- `prosa schedule …` — `install | status | uninstall` (LaunchAgent /
systemd timer).
- `prosa setup` — interactive first-run wizard.
- `prosa login` — re-authenticate (sub-step of setup).
Global flags:
- `--last`, `--since`, `--between`
- `--project`, `--device`, `--agent`
- `--all`
- `--remote`
- `--json`
- `--no-color`
Keep flags stable across cuts. Renaming or removing is a breaking change
and requires updating `docs/usage.md` in the same PR.
## Rendering rules
- Timeline, search, show, and analytics are one-shot renderers; no
resident TUI.
- TTY output may use Lipgloss colors and responsive truncation per
`docs/cli/rendering-contract.md`.
- Non-TTY output must be plain text or NDJSON without escape codes.
- `prosa sync` may use Bubble Tea progress in interactive terminals,
with a plain structured fallback for cron/LaunchAgent/systemd use.
See `docs/cli/motion.md` for the