project-status

Monitor workflow phase and runtime agent status from a SQLite database.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/merong/cmux-workshop --skill project-status-merong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-status
Source: https://github.com/merong/cmux-workshop/tree/main/plugins/cmux-workshop/skills/project-status
Command: npx skills add https://github.com/merong/cmux-workshop --skill project-status-merong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Show current project workflow progress and runtime agent status within a cmux-workshop setup. It allows quick assessment of the current phase and which agents are running, across PRD, Agent design, and deployment.

Core Features & Use Cases

  • Tracks and displays the current workflow phase (PRD / Agents / Deployed) and runtime agent status.
  • Reads from the local SQLite database (.claude/project.db) when available, migrates legacy schemas, and cross-references the live cmux tree with saved CLI session metadata.
  • Works from any phase and guides the next steps, including optional runtime checks inside cmux.

Quick Start

Run the skill to view the current workflow phase and runtime agent state.

Frequently Asked Questions about project-status

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

FAQPage Schema
How do I check runtime agent status and current workflow phase in a cmux-workshop project?

To check runtime agent status and workflow phase, run the skill to read the local SQLite database and CLI session metadata. It cross-references the live cmux tree to report the active phase (PRD, Agents, or Deployed) and running agent states.

What is the best way to track project progress from PRD through deployment using a local SQLite database?

The best way to track project progress is reading the .claude/project.db SQLite database to determine the active workflow phase. It performs legacy schema migrations if needed and prints a structured status overview across PRD, agent design, and deployment phases.

Does this project status monitor work if my SQLite database has a legacy schema?

Yes, the project status monitor works with legacy schemas by performing automatic migrations when reading .claude/project.db. It ensures compatibility by migrating the stored data before cross-referencing it with the live cmux workspace tree.

Can I monitor deployed agent state and configured agents across different project phases?

Yes, you can monitor deployed agent state and configured agents across any project phase. The tool applies across PRD, agent design, and deployment phases to determine the active phase, identify configured agents, and check the deployed state.

Why does my project status check show a different workflow phase than the live cmux workspace tree?

A project status check may show a different phase because it optionally compares the live workspace tree against stored surfaces in the SQLite database. Discrepancies occur when local files and saved CLI session metadata are not synchronized.

Do I need a running cmux session to check agent health and workflow phase?

No, a running cmux session is not strictly needed to check agent health and workflow phase. The skill reads saved CLI session metadata and the local SQLite database, but optionally performs live runtime checks inside cmux for real-time status.