Show current workflow progress and status
Check your project's workflow progress and status. Use this to see what's been completed, what's in progress, and what's next—especially useful after interruptions or to track implementation progress.
/plugin marketplace add webdevtodayjason/titanium-plugins/plugin install titanium-toolkit@titanium-pluginsYou are reporting on the current workflow state and progress. This command provides a comprehensive view of where the project stands, what's been completed, and what's remaining.
This command will:
uv run ${CLAUDE_PLUGIN_ROOT}/hooks/utils/workflow/workflow_state.py get "$(pwd)"
If workflow exists:
If no workflow exists:
Use Pieces LTM to get recent work history:
mcp__Pieces__ask_pieces_ltm(
question: "What work has been done in the last session on this project at [current directory]? What was being worked on? What was completed? What was left unfinished?",
chat_llm: "claude-sonnet-4-5",
topics: ["workflow", "implementation", "development"],
application_sources: ["Code"]
)
Extract from Pieces:
# Check if plan exists
ls .titanium/plan.json
If plan exists:
.titanium/plan.jsonCalculate progress (if TodoWrite is available):
Note: TodoWrite state is session-specific. This step only works if we're in the same session that created the workflow.
If TodoWrite is available in current session:
If TodoWrite not available:
Overall Progress:
progress_percentage = (completed_tasks / total_tasks) * 100
Time Metrics:
elapsed_time = current_time - workflow.started_at
remaining_tasks = total_tasks - completed_tasks
avg_time_per_task = elapsed_time / completed_tasks (if > 0)
estimated_remaining = avg_time_per_task * remaining_tasks
Phase Progress:
📊 Titanium Workflow Status
═══════════════════════════════════════════════
🎯 Goal: [workflow.goal]
📍 Current Phase: [current_phase]
Status: [status emoji] [status]
⏱️ Timeline:
Started: [formatted timestamp] ([X] hours/days ago)
[If completed: Completed: [timestamp]]
[If in progress: Elapsed: [duration]]
───────────────────────────────────────────────
📈 Progress: [X]% Complete
✅ Completed: [X] tasks
⏳ Pending: [Y] tasks
🔄 Current: [current task name if known]
───────────────────────────────────────────────
📦 Project Structure:
Epics: [X]
Stories: [Y]
Tasks: [Z]
Total Estimated Time: [time]
🤖 Agents Used/Planned:
[List agents with their roles]
───────────────────────────────────────────────
📝 Recent Work (from Pieces):
[Summary from Pieces query - what was done recently]
Key Accomplishments:
- [Item 1]
- [Item 2]
- [Item 3]
Current Focus:
[What's being worked on now or what's next]
───────────────────────────────────────────────
🔄 Phase History:
1. ✅ Planning - Completed ([duration])
2. 🔄 Implementation - In Progress (started [time ago])
3. ⏳ Review - Pending
4. ⏳ Completion - Pending
───────────────────────────────────────────────
⏰ Time Estimates:
Elapsed: [duration]
Est. Remaining: [duration] (based on current pace)
Original Estimate: [total from plan]
[If ahead/behind schedule: [emoji] [X]% [ahead/behind] schedule]
───────────────────────────────────────────────
📁 Key Files:
Created/Modified:
[List from Pieces or plan if available]
Configuration:
- Plan: .titanium/plan.json
- State: .titanium/workflow-state.json
[If exists: - Review: .titanium/review-report.md]
───────────────────────────────────────────────
💡 Next Steps:
[Based on current state, suggest what should happen next]
1. [Next action item]
2. [Second action item]
3. [Third action item]
───────────────────────────────────────────────
🔊 Voice Summary Available
Say "yes" for voice summary of current status
📊 Status: Planning Phase
🎯 Goal: [goal]
Current Activity:
- Analyzing requirements
- Generating implementation plan
- Validating with vibe-check
Next: Implementation phase will begin after plan approval
📊 Status: Implementation In Progress
🎯 Goal: [goal]
Progress: [X]% ([completed]/[total] tasks)
Current Task: [task name]
Agent: [current agent]
Recently Completed:
- [Task 1] by @agent-1
- [Task 2] by @agent-2
- [Task 3] by @agent-3
Up Next:
- [Next task 1]
- [Next task 2]
Estimated Remaining: [time]
📊 Status: Quality Review Phase
🎯 Goal: [goal]
Implementation: ✅ Complete ([X] tasks finished)
Current Activity:
- Running quality review
- @code-reviewer analyzing code
- @security-scanner checking vulnerabilities
- @tdd-specialist reviewing tests
Next: Address review findings, then complete workflow
📊 Status: Workflow Complete ✅
🎯 Goal: [goal]
Completion Summary:
- Started: [timestamp]
- Completed: [timestamp]
- Duration: [total time]
Deliverables:
- [X] epics completed
- [Y] stories delivered
- [Z] tasks finished
Final Metrics:
- Test Coverage: [X]%
- Quality Review: [findings summary]
- All work stored in Pieces ✅
Next: Run /catchup in future sessions to resume context
📊 Status: No Active Workflow
Current Directory: [pwd]
No .titanium/workflow-state.json found
Checking for plan...
[If plan exists: Plan found but not yet executed]
[If no plan: No plan found]
Checking Pieces for history...
[Results from Pieces query]
---
Ready to start a new workflow?
Run:
- /titanium:plan [requirements] - Create implementation plan
- /titanium:work [requirements] - Start full workflow
If user requests voice summary or says "yes" to voice option:
Create concise summary for TTS (under 100 words):
"Workflow status: [Phase], [X] percent complete.
[Completed count] tasks finished, [pending count] remaining.
Currently working on [current task or phase activity].
[Key recent accomplishment].
Estimated [time] remaining.
[Next major milestone or action]."
Example:
"Workflow status: Implementation phase, sixty-seven percent complete.
Eight tasks finished, four remaining.
Currently implementing the login form component with the frontend developer agent.
Just completed the backend authentication API with all tests passing.
Estimated one hour remaining.
Next, we'll run the quality review phase."
Announce using existing TTS:
User: /titanium:plan [requirements]
[... plan created ...]
User: /titanium:status
Shows:
- Phase: Planning (completed)
- Plan details
- Ready for /titanium:work
User: /titanium:work
[... implementation in progress ...]
User: /titanium:status
Shows:
- Phase: Implementation (in progress)
- Progress: X%
- Current task
- Time estimates
User: /titanium:work
[... completes ...]
User: /titanium:status
Shows:
- Phase: Completed
- Summary of deliverables
- Quality metrics
User: (new session)
/titanium:status
Shows:
- Workflow state from file
- Pieces context from previous session
- Can resume work
⚠️ Workflow state file exists but is corrupted
Attempting to recover from Pieces...
[Query Pieces for last known state]
[If recovery successful: Use Pieces data]
[If recovery fails: Report what's known, suggest starting fresh]
Note: Pieces MCP not available. Status based on local files only.
To enable full context recovery:
1. Install Pieces OS (https://pieces.app)
2. Install Pieces CLI (pip3 install pieces-cli)
3. Configure MCP (pieces mcp setup claude_code --stdio)
4. Restart Claude Code
📊 Status: No Data Available
Current Directory: [pwd]
- No workflow state file (.titanium/workflow-state.json)
- No plan file (.titanium/plan.json)
- Pieces query returned no results
This appears to be a new project or no workflows have been run yet.
Ready to start? Run:
- /titanium:plan - Create implementation plan
- /titanium:work - Start full workflow
User: How's the workflow going?
Claude: Let me check the status.
[Runs /titanium:status]
Claude: We're 60% through implementation. 6 of 10 tasks complete.
Currently working on the frontend login form.
About 2 hours remaining.
User: (new session) What was I working on?
Claude: Let me check.
[Runs /titanium:status]
Claude: You were implementing user authentication.
Phase: Implementation (in progress)
Last completed: Backend API by @api-developer
Next up: Frontend forms by @frontend-developer
Would you like to continue with /titanium:work?
User: Is implementation done? Can we review?
Claude: Let me check status.
[Runs /titanium:status]
Claude: Yes! Implementation is 100% complete.
All 12 tasks finished.
Ready for quality review.
Run /titanium:review to start the review process.
User: What did we accomplish yesterday?
Claude: Checking status and history...
[Runs /titanium:status + Pieces query]
Claude: Yesterday's work:
- Completed Backend API epic (3 stories, 7 tasks)
- @api-developer implemented JWT middleware
- @api-developer created login/register endpoints
- @test-runner wrote integration tests
- All tests passing
Today: Moving to Frontend epic
Voice hooks may announce:
Potential enhancements:
This command provides comprehensive workflow status with context from state files, Pieces LTM, and current session, enabling users to track progress and make informed decisions about next steps.