Skip to content

feat: Taskmaster Flow interactive terminal UI#883

Closed
joedanz wants to merge 327 commits intoeyaltoledano:mainfrom
joedanz:joedanz/tm-flow
Closed

feat: Taskmaster Flow interactive terminal UI#883
joedanz wants to merge 327 commits intoeyaltoledano:mainfrom
joedanz:joedanz/tm-flow

Conversation

@joedanz
Copy link
Contributor

@joedanz joedanz commented Jun 26, 2025

Task Master Flow - Interactive TUI for Task Management

This PR introduces Task Master Flow, a modern interactive Terminal User Interface (TUI) for Task Master that provides a more intuitive way to manage tasks and interact with the system.

Key Features

Interactive TUI with Slash Commands

  • Slash command navigation system (/tasks, /parse, /analyze, etc.)
  • Real-time task status updates and filtering
  • Keyboard shortcuts for common operations (Ctrl+X shortcuts menu)

Multiple View Screens

  • Welcome Screen: Main hub with available commands
  • Task Management: Interactive task list with status cycling and filtering
  • Tag Management: Manage tagged task contexts
  • Parse PRD: Parse requirements documents to generate tasks
  • Analyze Complexity: View task complexity analysis
  • Chat Screen: AI assistant integration
  • MCP Management: Configure and manage MCP servers
  • Status Screen: Project overview and statistics

Integration Features

  • Seamless integration with existing task-master commands
  • Launch model and rules configuration directly from the TUI
  • Automatic return to Flow after external setup completion
  • Support for light/dark theme switching

Technical Implementation

  • Built with React and Ink v5 for terminal rendering
  • Modular backend architecture supporting Direct, CLI, and MCP backends
  • New dependencies: ink-select-input, ink-spinner, ink-text-input

Usage

# Launch the interactive TUI
task-master flow

# Or use the alias
tm flow

Changes Summary

  • Added: Complete /scripts/modules/flow/ directory with 40+ new files
  • Added: Flow command to CLI (scripts/modules/commands.js)
  • Modified: Package dependencies for Ink components
  • Modified: README to include Flow documentation

This feature significantly improves the user experience by providing a modern, interactive alternative to the traditional CLI commands while maintaining full compatibility with existing workflows.

@changeset-bot
Copy link

changeset-bot bot commented Jun 26, 2025

🦋 Changeset detected

Latest commit: 5daefe1

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

joedanz and others added 28 commits July 15, 2025 14:31
- Modified index-root.jsx to properly pass environment variables when run directly
- Enhanced fallback logic in index.jsx ServiceProvider for robust projectRoot detection
- Ensures --project-root flag is correctly passed through the CLI → wrapper → TUI chain

Fixes issue where Flow TUI was using local folder instead of specified --project-root
…ster into joedanz/tm-flow

# Conflicts:
#	.gitignore
#	.taskmaster/config.json
#	package-lock.json
#	package.json
#	scripts/modules/task-manager/research.js
@Crunchyman-ralph
Copy link
Collaborator

prioritizing #1332 thanks for the contrib Joe!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants