CI Status
GitHub Actions and CircleCI status grouped by provider and workflow, interactive TUI details, log access, auto-watch, widget, notifications, and LLM CI tools.
Overview
GitHub Actions and CircleCI status grouped by provider and workflow, interactive TUI details, log access, auto-watch, widget, notifications, and LLM CI tools.
Package docs also remain available on the package summary page at /docs/ci-status, but this page focuses on the Pi-native extension surface: commands, tools, environment variables, packaged skills, and extension files.
Commands
| Command | Does |
|---|---|
| /ci | Fetch and render CI status for the current branch/PR in the widget area |
| /ci-detail or Ctrl+Shift+. | Open interactive TUI detail view grouped by CI provider and workflow/cycle, automatic focus on the most important CI/cycle, sorted job list, details, log access, selected failed-job rerun, guided fix prompts, browser open, and copy URL |
| /ci-logs | Fetch and display logs for a job by name or id |
| /ci-refresh | Force-refresh CI status |
| /ci-watch | Watch CI status and notify when failures/recoveries occur |
| /ci-unwatch | Stop watching CI status |
| /ci-clear | Clear the CI widget/status from the UI |
LLM Tools
| Tool | Does |
|---|---|
| get_ci_status | Fetch latest CI status for the current branch/PR with per-job IDs, URLs, durations, and provider metadata |
| ci_fetch_job_logs | Fetch failure logs for a specific job using jobId, GitHub runId, or CircleCI jobNumber |
Environment
- gh CLI must be installed and authenticated for GitHub Actions/PR lookup.
- Set CIRCLECI_TOKEN to enrich CircleCI checks with workflow/job details.
- Set PI_CI_AUTO_WATCH=0 to disable automatic startup watch.
- Set PI_CI_SHOW_WIDGET_ON_START=1 to show the CI widget immediately on startup.
- Set PI_CI_DETAIL_SHORTCUT to override the /ci-detail shortcut, default ctrl+shift+..
UI Shortcuts
- Ctrl+Shift+. opens /ci-detail.
- ? / h open help
- Tab / ←→ switch between CI providers
- [ / ] switch workflow/cycle inside the active CI
- p pick a CI provider with a native Pi selector
- w pick a workflow/cycle with a native Pi selector
- R refresh CI status in place while preserving selection when possible
- a toggle important-only vs all jobs in the active cycle
- ↑↓ navigate jobs/logs
- Enter open job detail or fetch logs in detail view
- r fetch logs for selected job
- f jump to the first error-like log line after logs are loaded
- F start a guided fix flow for the selected job: pick a model, review a context-rich prompt, press e to edit, Enter to run, or the configured app.message.followUp key to queue
- x rerun the selected failed job one-by-one (gh run rerun --job for GitHub Actions; CircleCI reruns require enriched workflow data and CIRCLECI_TOKEN)
- l open the selected job URL in browser
- c copy the selected job URL; the view shows the exact copy target
- g jump to first failing job, switching CI/cycle if needed
- Esc close/back
Extension Files
Primary extension path: pi-packages/ci-status/extensions/ci-status
index.ts
Installation
bash
# From the agent-skills-marketplace repo root
pi install "$PWD/pi-packages/ci-status"
# From the Diversio monolith root
pi install "$PWD/agent-skills-marketplace/pi-packages/ci-status"Local test or verification snippet:
bash
# From the agent-skills-marketplace repo root
pi --no-extensions -e ./pi-packages/ci-status