flow-status

Read local FLOW state files to display branch phase and PR context.

25|3|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/benkruger/flow --skill flow-status-benkruger
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow-status
Source: https://github.com/benkruger/flow/tree/main/skills/flow-status
Command: npx skills add https://github.com/benkruger/flow --skill flow-status-benkruger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly determine the current stage of your FLOW feature by reading the local state and presenting a concise status panel without modifying anything.

Core Features & Use Cases

  • Read the state file from .flow-states/<branch>/state.json to derive branch, phase, and timing.
  • Display the PR link (if present) and upcoming steps to keep teams aligned.
  • Operates read-only on laptops and CI machines, enabling quick progress checks during feature development.

Quick Start

Run the flow-status command to print the current FLOW panel for your active branch.

Frequently Asked Questions about flow-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the current development phase of my branch?▼

To check the current development phase of your branch, run a read-only status command that parses local .flow-states/<branch>/state.json data to display the phase, elapsed time, and continuation guidance.

What is the best way to monitor FLOW feature state without modifying files?▼

The best way to monitor FLOW feature state without modifying files is to use a read-only status panel that surfaces branch-aware phase, timing, and PR context directly from local state data.

Can I view PR context and next steps for multi-branch projects?▼

Yes, you can view PR context and next steps for multi-branch projects by reading branch-specific local state data to provide branch-aware status, timing, and continuation guidance across the repository.

Does the FLOW status panel work on CI machines?▼

Yes, the FLOW status panel works on CI machines as well as local laptops, operating strictly read-only to enable quick progress checks during feature development without altering state.

How do I display the elapsed time and PR link for my current workflow?▼

You can display the elapsed time and PR link for your current workflow by running a command that reads .flow-states/<branch>/state.json to derive and present timing and PR context in a concise panel.