Skip to main content
The /status command displays the current state of your project, including agent activity, file statistics, and preview server status.

​
When to use this

Progress tracking

See what’s been completed and what’s pending

Agent activity

Check which agents are working

Project overview

Understand current project state

Before continuing

Resume work after a break

​
What it shows

​
1. Project Info

  • Project name and path
  • Tech stack
  • Current features

​
2. Agent Status Board

  • Which agents are running
  • Which tasks are completed
  • Pending work

​
3. File Statistics

  • Files created count
  • Files modified count

​
4. Preview Status

  • Is server running
  • URL
  • Health check

​
Example output

=== Project Status ===

📁 Project: my-ecommerce
📂 Path: C:/projects/my-ecommerce
🏷️ Type: nextjs-ecommerce
📊 Status: active

🔧 Tech Stack:
   Framework: next.js
   Database: postgresql
   Auth: clerk
   Payment: stripe

✅ Features (5):
   • product-listing
   • cart
   • checkout
   • user-auth
   • order-history

⏳ Pending (2):
   • admin-panel
   • email-notifications

📄 Files: 73 created, 12 modified

=== Agent Status ===

✅ database-architect → Completed
✅ backend-specialist → Completed
🔄 frontend-specialist → Dashboard components (60%)
⏳ test-engineer → Waiting

=== Preview ===

🌐 URL: http://localhost:3000
💚 Health: OK

​
Understanding the output

​
Project section

Shows your project name, location, type, and current status (active, paused, or error).

​
Tech stack

Lists the frameworks, libraries, and services your project uses.

​
Features

  • Completed features (✅): Implemented and working
  • Pending features (⏳): Planned but not yet implemented

​
Agent status

  • ✅ Completed: Agent finished its work
  • 🔄 In Progress: Agent currently working (with percentage if available)
  • ⏳ Waiting: Agent queued to start

​
File statistics

Shows how many files were created or modified during this session.

​
Preview status

Indicates if your development server is running and accessible.

​
Technical details

The status command uses: 
# Get project and agent status
python .agent/scripts/session_manager.py status

# Get preview server status
python .agent/scripts/auto_preview.py status

​
Usage examples

/status
Show complete project status

Build docs developers (and LLMs) love

Get started for freeTalk to us