task-master-viewer_skill

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.