← ClaudeAtlas

prosa-cli-renderinglisted

CLI behavior and rendering conventions for prosa. Use when changing internal/cli commands, flags, timeline/search rendering, TTY behavior, or progress output.
c3-oss/prosa · ★ 1 · AI & Automation · score 57
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