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.