# Meridian:status

> Use when you need Meridian to show Project Status.

- Skill: `mattjaikaran/meridian-status` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mattjaikaran/meridian-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mattjaikaran/meridian-status/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mattjaikaran (https://skillmd.com/u/mattjaikaran)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mattjaikaran/meridian-status

---


# /meridian:status — Show Project Status

Display current Meridian state: progress, phase status, blockers, and computed next action.

## Procedure

### Step 1: Load State
```bash
PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
import json
from scripts.db import connect, get_db_path
from scripts.state import get_status
conn = connect(get_db_path('.'))
status = get_status(conn)
print(json.dumps(status, indent=2, default=str))
conn.close()
"
```

### Step 2: Format Output

Display in this format:

```
# Meridian Status — {project_name}

## Milestone: {milestone_name} ({status})

### Phases
| # | Phase | Status | Plans |
|---|-------|--------|-------|
| 1 | Foundation | complete | 3/3 |
| 2 | Features | executing | 1/4 |
| 3 | Polish | planned | 0/0 |

### Current Phase: {phase_name}
Status: {phase_status}
Acceptance Criteria:
- [ ] criterion 1
- [x] criterion 2

### Plans (Phase {N})
| Wave | Plan | Status |
|------|------|--------|
| 1 | Setup DB | complete |
| 1 | Create models | executing |
| 2 | Add API routes | pending |

### Recent Decisions
- [{category}] {summary}

### Next Action
→ {computed_next_action}

### Last Checkpoint
{checkpoint_time} — {trigger}: {notes}
```

### Step 3: Show Git State
Include current branch, last commit, and dirty status.

## Options
- `--full` — Show all milestones, all phases, all decisions
- `--json` — Output raw JSON instead of formatted table
- `--all-workstreams` — Show progress across every workstream (portfolio view)

## Step 4 (if --all-workstreams): Show Workstream Portfolio
```bash
PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
import json
from scripts.db import open_project
from scripts.workstreams import get_all_workstreams_progress, get_active_workstream
with open_project('.') as conn:
    active = get_active_workstream(conn)
    all_prog = get_all_workstreams_progress(conn)
    print(json.dumps({'active': active, 'workstreams': all_prog}, indent=2))
"
```

Format as:

```
## Workstream Portfolio

Active: <slug> (or none)

| Workstream | Status | Milestones | Phases Done | Progress |
|------------|--------|------------|-------------|----------|
| backend-rewrite | active | 2 | 5/12 | 42% |
| mobile-app | paused | 1 | 3/4 | 75% |
```