--- name: circle-cli description: Views CircleCI pipelines, workflows, jobs, and output. Use when investigating CI failures or checking pipeline status. --- # CircleCI CLI ## Commands ```bash circle pipelines list # Recent pipelines for current branch circle pipelines list --branch main -n 5 # 5 pipelines for main branch circle workflows list --pipeline # Workflows for a pipeline circle jobs list --pipeline # All jobs for a pipeline circle jobs list --pipeline --status failed # Only failed jobs circle jobs details # Job steps circle jobs details --step-status failed # Only failed steps circle jobs tests --status failed # Failed tests (use BEFORE output!) circle jobs tests --status failed -m # Failed tests with messages circle jobs output --step # Step output (expensive, use last) circle jobs output --step --try-extract-summary # Extract test summary circle jobs output --step --parallel-index # Parallel run output ``` ## Investigating failures **IMPORTANT: Conserve tokens by using targeted commands. Filter for failures.** 1. `circle pipelines list` - find the failing pipeline 2. `circle jobs list --pipeline --status failed` - find failed jobs 3. `circle jobs details --step-status failed` - find failed steps 4. `circle jobs tests --status failed` - identify which tests failed (low token cost) 5. `circle jobs tests --status failed -m` - view failure messages (often sufficient to diagnose) 6. `circle jobs output --step --try-extract-summary` - only if more context needed (high token cost) 7. `circle jobs output --step ` - last resort **Key principle:** Use `jobs tests --status failed` before `jobs output`. Test metadata is compact; full output is expensive. The failure messages (`-m`) often contain enough information to diagnose the issue. Investigate all failures unless told otherwise. Watch for flaky or unrelated failures.