mattjaikaran /meridian:status — Show Project Status
Display current Meridian state: progress, phase status, blockers, and computed next action.
Procedure
Step 1: Load State
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
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% |