---
description: Show current project/Work Item state, map staleness, memory count
---

# /flow-status

Show where you are, what's next, how stale the map is, and how much durable memory you carry.

## What it shows

Call `flow_tools` for each read-only operation:

- `state_get` — active_work_item, status, updated_at, git_commit
- `state_validate` — frontmatter + required fields
- `audit_open` — `.flow` integrity (state.md + work-items/ + map.json)
- `files_check` with `paths: [".flow/memory.md"]` and `lineCount: true` — size

Report:

```
📍 FLOW Status

Work Item:  [work-item-NNN or —]
Status:     [ready | planned | in-progress | in-review | complete]
Updated:    [updated_at]
Git:        [git_commit from state.md] vs HEAD [git rev-parse HEAD]

Map:        .flow/map.json [commit a1b2c3d, N files, generated YYYY-MM-DD]
            [✅ fresh | ⚠️ N commits old — run /flow-map]

Memory:     .flow/memory.md — [N] Facts / [M] Decisions / [K] Lessons · [L] lines
Work Items: [count] in .flow/work-items/

Next step: [/flow "…"] or [/flow (continue work-item-NNN)] or [/flow-init if greenfield]
```

## Staleness

Compare `map.json git_commit` vs `git rev-parse HEAD`. If drift >0, print `map is N commits old — run /flow-map`. Do not auto re-index. If not a git repo, compare `generated_at` + `files_indexed`.

## When to use

Run at session start, before planning, or whenever you need orientation. Replaces `flow-progress` (minus milestone/phase table) and `flow-health` workflow surface — health checks are now the `flow_tools` operations `audit_open`, `state_validate`, and `state_sync`.