---
description: Show CIAgent project status — current phase, milestone, pipeline stage, decisions, escalations, and requirements coverage
---

# CIAgent Status

Display the current CIAgent project status derived entirely from the git log and .ciagent/ files.

**Usage:** `ciagent-status`

## Step 0: Confirm Active Project

Check `ci listProjects()` or read `.ciagent/config.json` to determine if multi-project mode is active.

If `.ciagent/config.json` has `projects[]` with length > 0:
- Show project list with active project indicator
- Confirm `active_project` is the project to show status for
- If not, set it with `ci setActiveProject(<slug>)`
- All commit messages must include `project: <slug>` in `---ci---` block

If single-project mode: proceed with existing conventions.

## Step 1: Load Git Context

```bash
git log --max-count=30
git branch -a
```

Use GitContext.reconstructState() to get:
- Current phase
- Current milestone
- Current pipeline stage
- Completed phases

## Step 2: Gather Details

Collect from git log:
- GitContext.getDecisions() — all decisions
- GitContext.getEscalations() — pending escalations
- GitContext.getRequirementsCoverage() — covered/partial requirements
- GitContext.getLessons() — learned lessons
- GitContext.getCompounds() — compound learnings

## Step 3: Read .ci/ Files

Read:
- `.ciagent/PROJECT.md` — project name and vision
- `.ciagent/ROADMAP.md` — phase list with status
- `.ciagent/config.json` — autonomy level

## Step 4: Display Status

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 CIAgent ► STATUS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Project: [name]  [If multi-project: (active)]
[If multi-project: Other projects: [name1], [name2]]
Milestone: [current] [NFR|Feature]
Phase: [N] — [name]
Stage: [current_stage]
Autonomy: [level]

Phases:
  ✓ [N] [name] (complete)
  → [N] [name] (in progress)
  ○ [N] [name] (not started)

Decisions: [N] total
Escalations: [N] pending
Requirements: [N] covered, [N] partial

Recent commits:
  [hash] [subject]
  [hash] [subject]
  [hash] [subject]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

If no `.ciagent/` directory exists: report "Project not initialized. Run ciagent-init first."