home / skills / sfc-gh-dflippo / snowflake-dbt-demo / task-master-viewer

task-master-viewer skill

safe

This skill lets you launch a visual Task Master editor for editing tasks.json via Streamlit, simplifying task management.

npx playbooks add skill sfc-gh-dflippo/snowflake-dbt-demo --skill task-master-viewer

Review the files below or copy the command above to add this skill to your agents.

Files (4)

SKILL.md

3.1 KB

---
name: task-master-viewer
description:
  Launch a Streamlit GUI for Task Master tasks.json editing. Use when users want a visual interface
  instead of CLI/MCP commands.
---

# 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

```bash
python -c "import streamlit" 2>/dev/null && echo "✓ Installed" || pip install -U streamlit
```

### 2. Launch Application

```bash
cd .claude/skills/task-master-viewer && streamlit run app.py
```

**Output:**

```sql
Local URL: http://localhost:8501
```

App opens automatically in user's browser.

### 3. Tell User

```sql
✓ 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):

```bash
# User presses Ctrl+C
```

**Kill Process**:

```bash
pkill -f "streamlit run"
```

**Background** (if needed):

```bash
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**:

```sql
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.
```

Overview

This skill launches a Streamlit GUI for visually viewing and editing Task Master tasks.json files. It provides a browser-based editor that surfaces task hierarchies, tagged lists, and common task operations. Use it when you prefer a visual interface over CLI or direct JSON edits.

How this skill works

The skill runs a Streamlit app located in the skill directory and opens a local web UI (default http://localhost:8501). It loads the project's tasks.json (default PROJECT_ROOT/.taskmaster/tasks/tasks.json), lets you view, reorder, and edit tasks, and writes changes back to the JSON file. The app includes reload and help controls and uses Snowflake-themed UI styling.

When to use it

You want to inspect tasks visually instead of using CLI commands.
You need to edit multiple tasks or reorganize task hierarchies quickly.
You prefer a browser-based interface for safer edits and previews.
You are on a local machine with a browser available.
You want a guided UI with built-in help and reload controls.

Best practices

Confirm Streamlit is installed before launching (pip install -U streamlit).
Run the app from the skill directory to avoid path errors.
Tell collaborators the local URL and how to stop the app.
Avoid editing tasks.json with another editor while the app is open.
Stop the app when done to avoid port conflicts or orphan processes.

Example use cases

Quickly reorganize a complex task hierarchy without hand-editing JSON.
Batch-edit tags or properties across multiple tasks via a visual list.
Onboard a teammate who prefers GUI tools instead of CLI commands.
Preview task changes and reload from disk after external edits.
Troubleshoot missing tasks by visually locating entries and metadata.

FAQ

How do I start the GUI?

Install Streamlit if needed, cd into the skill folder, then run: streamlit run app.py. The app opens at http://localhost:8501.

Where does the app read and save tasks?

By default it uses PROJECT_ROOT/.taskmaster/tasks/tasks.json. You can change the path in the app sidebar if needed.

How do I stop the app?

Close the browser tab and press Ctrl+C in the terminal. If needed, kill background processes with pkill -f "streamlit run".