para-status

/para-status

Show an overview of your PARA system — item counts, statuses, and attention-needed flags.

Usage

/para-status [category]

• No argument: Show overview of all categories
• projects, areas, resources, or archive: Show details for that category only

Steps

Find the PARA Root

Look for .para-config.json in:

• Current working directory
• ~/para/
• Walk up from current directory

If not found, tell the user to run /para-setup first.

Overview Mode (no category specified)

1. Scan all categories. For each of Projects, Areas, Resources, Archive:

   • Count the number of items (directories containing context.md)
   • Read each item's context.md to extract status info

2. Build the overview table:

   PARA System Overview ({PARA_ROOT})
   ══════════════════════════════════
   
   📂 Projects: {count} active
     • {name} — {phase}, {health}
     • {name} — {phase}, {health}
   
   📂 Areas: {count} active
     • {name} — {health}
     • {name} — {health}
   
   📂 Resources: {count} items
     • {name} — last reviewed {date}
     • {name} — last reviewed {date}
   
   📦 Archive: {count} items
   

3. Add attention flags at the bottom:

   • ⚠️ Projects at risk or off track
   • ⚠️ Areas marked "Needs Attention" or "Neglected"
   • ⚠️ Resources not reviewed in 3+ months
   • ⚠️ More than 10 active projects (overcommitted)
   • ⚠️ Items with empty or minimal context.md

Category Detail Mode

When a specific category is provided:

1. List all items in that category with full status details
2. For Projects: Show phase, health, target date, milestone progress (count of checked vs total checkboxes)
3. For Areas: Show health, standards count, cadence items
4. For Resources: Show tags, last reviewed date, source count
5. For Archive: Show item names and which original category they came from (if detectable from context.md)

Reading Status from context.md

Extract status by reading context.md and parsing:

• Phase: Look for **Phase:** line
• Health: Look for **Health:** line
• Target Date: Look for **Target Date:** line
• Last Updated: Look for **Last Updated:** line
• Last Reviewed: Look for ## Last Reviewed section (Resources)
• Tags: Look for ## Tags section (Resources)