task-master-viewer
Launch a Streamlit GUI for Task Master tasks.json editing. Use when users want a visual interface instead of CLI/MCP commands.
When & Why to Use This Skill
The Task Master Viewer is a Streamlit-based graphical user interface (GUI) designed for visual management of Task Master tasks.json files. It provides an intuitive alternative to CLI and MCP commands, allowing users to browse, edit, and reorganize task hierarchies directly in their web browser for enhanced productivity and project oversight.
Use Cases
- Visualizing complex task lists and hierarchies that are difficult to navigate via command-line interfaces.
- Performing bulk updates and edits to multiple tasks simultaneously through a streamlined web-based editor.
- Reorganizing project structures and task priorities using a visual interface instead of manual JSON file modification.
- Providing a user-friendly dashboard for users who prefer a browser-based interaction over terminal commands.
| name | task-master-viewer |
|---|
Task Master Viewer
Visual GUI for managing Task Master tasks.json files.
When to Use
Use when:
- User asks to "view tasks visually", "open task editor", "launch GUI", or "see tasks in browser"
- User wants to edit multiple tasks without typing commands
- User needs to reorganize task hierarchy
- CLI/MCP tools feel cumbersome
Don't use when:
- User is comfortable with CLI (
task-master list, etc.) - User wants to script or automate tasks
- Headless/server environment without browser
Quick Start
1. Check Streamlit Installation
python -c "import streamlit" 2>/dev/null && echo "✓ Installed" || pip install -U streamlit
2. Launch Application
cd .claude/skills/task-master-viewer && streamlit run app.py
Output:
Local URL: http://localhost:8501
App opens automatically in user's browser.
3. Tell User
✓ Task Master editor is open at http://localhost:8501
To stop: Close browser tab and press Ctrl+C
Technical Details
File Location: .claude/skills/task-master-viewer/app.py
Dependencies: streamlit (only requirement)
Default Path: PROJECT_ROOT/.taskmaster/tasks/tasks.json
Port: 8501 (auto-increments if busy)
Theme: Snowflake brand colors in .streamlit/config.toml
Data Format: Standard Task Master JSON with tagged task lists
Stopping the App
Foreground (default):
# User presses Ctrl+C
Kill Process:
pkill -f "streamlit run"
Background (if needed):
cd .claude/skills/task-master-viewer
nohup streamlit run app.py > /dev/null 2>&1 &
echo $! > streamlit.pid
# To stop:
kill $(cat streamlit.pid)
Common Issues
| Issue | Solution |
|---|---|
| "Address already in use" | pkill -f "streamlit run" then restart |
| "Module 'streamlit' not found" | pip install streamlit |
| Wrong directory error | Must run from .claude/skills/task-master-viewer/ |
| File not found | User sets path in sidebar settings |
Best Practices
Do:
- ✅ Check/install Streamlit before launching
- ✅ Run from skill directory
- ✅ Tell user the URL
- ✅ Explain how to stop
- ✅ Mention all instructions are in the app
Don't:
- ❌ Leave running indefinitely
- ❌ Launch multiple instances
- ❌ Edit tasks.json while app is open
- ❌ Explain features (app has help text)
Integration
Works alongside:
- Task Master CLI commands
- Task Master MCP tools
- Direct JSON editing (use "🔄 Reload" button)
Example Response
User: "Can I see my tasks visually?"
Agent:
Installing Streamlit... ✓
Launching Task Master editor... ✓
Editor is open at http://localhost:8501
All instructions are in the app interface.
To stop: Close browser tab and press Ctrl+C.