Show the current status of a Ptah project — lifecycle state, registered repos, contracts, and plan progress. Use when the user asks about project status or wants to know what state their orchestration is in.
ptah list to see available projectsRun the ptah status command which provides a formatted overview:
ptah status [--project <name>]
This displays lifecycle, plan progress, task counts, and wave position.
For additional detail, read the project's state files from ~/.ptah/projects/<name>/:
config.json — show CLI tool, mode, max tokensSTATE.json — show lifecycle, repos registered, contracts discoveredECOSYSTEM.md — show registered repository summaryFormat and display:
╔══════════════════════════════════════╗
║ Ptah Project: <name> ║
╠══════════════════════════════════════╣
║ Lifecycle: <lifecycle state> ║
║ CLI Tool: <gemini-cli/claude> ║
║ Mode: <safe/auto-accept> ║
║ Repos: <count> registered ║
║ Contracts: <count> discovered ║
║ Plan: <current plan or N/A> ║
╚══════════════════════════════════════╝
Based on lifecycle state, suggest the logical next step:
idle → "Register repos with ptah:register"learning → "Run ptah:discover to find contracts"discovering → "Run ptah:plan to create task plan"planned → "Run ptah:execute to start execution"executing → "Continue execution or check progress"verifying → "Complete verification with ptah:verify"complete → "All done! Start a new plan if needed."