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.