Vibex Task Manager

An AI-powered task management system designed for modern development workflows. Vibex Task Manager uses AWS Bedrock exclusively to provide intelligent task generation, complexity analysis, and multi-agent coordination capabilities.

✨ Key Features

• 🎯 Zero-Configuration AWS Integration: Automatic model detection and setup
• 🤖 AI-Powered Task Management: Generate and manage tasks with Claude models
• 🔬 SPARC Methodology: A structured, AI-assisted workflow for complex problem-solving (Specification, Pseudocode, Architecture, Refinement, Completion).
• 🔗 MCP Integration: Seamless integration with AI-powered editors (Cursor, Claude Code, VS Code)
• 📊 Intelligent Analysis: Automatic task complexity assessment and recommendations
• 🤝 Multi-Agent Coordination: Enable multiple AI agents to work together effectively
• 🔒 Enterprise Security: AWS-grade security and compliance
• 💰 Cost Optimization: Pay-per-use AWS Bedrock pricing

🚀 Quick Start

1. Install Vibex Task Manager

Choose your preferred installation method:

MCP Integration (Recommended for AI Editors)

Add to your .cursor/mcp.json or equivalent:

{
  "mcpServers": {
    "vibex-task-manager": {
      "command": "npx",
      "args": ["-y", "--package=vibex-task-manager", "vibex"],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_DEFAULT_REGION": "us-east-1"
      }
    }
  }
}

Global CLI Installation

npm install -g vibex-task-manager

Project Dependency

npm install vibex-task-manager

2. Configure AWS Bedrock

Ensure you have AWS credentials configured and Bedrock access enabled:

# Configure AWS credentials (if not already done)
aws configure

# Test AWS Bedrock connection and auto-detect models
vibex config detect

3. Initialize Your Project

# Navigate to your project directory
cd your-project

# Initialize Vibex Task Manager with auto-detection
vibex init

# Or initialize with custom settings
vibex init --name "My Project" --description "Project description"

4. Unified Command Interface

NEW: Use the simplified vibex command for all operations!

# 🎯 Natural Language Task Creation (NEW!)
vibex "Create a simple hello world Python script called hello.py"
vibex "Build a REST API for user management with authentication"
vibex "Fix the login bug and add error handling"

# 📋 Traditional Task Management
vibex list                              # List all tasks
vibex show 5                           # Show task details
vibex next                             # Get next recommended task
vibex expand 5                         # Expand task into subtasks
vibex status 5 done                    # Set task status

# 🛠️ Project Management
vibex parse-prd requirements.md        # Parse PRD into tasks
vibex config setup                     # Configure AWS Bedrock
vibex init                             # Initialize project

# 🔌 MCP Server Mode
vibex mcp                              # Start MCP server for AI editors
vibex                                  # Auto-start MCP server (no args)

Legacy Commands: All vibex-task-manager commands still work for backward compatibility.

🤖 NEW: Agentic Development Assistant + Claude Code Integration

Transform your development workflow with natural language commands and Claude Code integration!

Quick Start with Vibex Dev

# Natural language development with Claude Code backend
vibex-dev --claude-code "Create a REST API for user management with CRUD operations"
vibex-dev --claude-code "Refactor the authentication service to use TypeScript interfaces"
vibex-dev --claude-code "Add comprehensive error handling to all API endpoints"

# Hybrid: Claude Code + Task Management
vibex-dev --claude-code --with-tasks "Build user authentication and track progress"
vibex-dev --claude-code --with-tasks "Fix the login bug and update task status"

# Smart model routing
vibex-dev --model-strategy smart "Optimize database performance"

# Traditional Bedrock mode (enterprise-optimized)
vibex-dev "Analyze codebase and suggest architectural improvements"

# See all examples including Claude Code integration
vibex-dev examples

🚀 Integration Options

| Mode | Backend | Best For | Cost | |------|---------|----------|------| | --claude-code | Claude Code | Complex coding tasks | Variable | | --model-strategy smart | Auto-routing | Balanced performance | Optimized | | Default | AWS Bedrock | Enterprise/cost control | Predictable |

Key Features

• 🗣️ Natural Language Interface: Describe what you want in plain English
• 🔌 Claude Code Integration: Best-in-class conversational development
• 🔧 Direct File Manipulation: AI reads, writes, and modifies your code
• 🧠 Multi-Backend Support: Claude Code, AWS Bedrock, or smart routing
• ⚡ Enterprise Optimized: Cost controls, audit trails, compliance
• 📋 Task Integration: Combines development with project management
• 🔄 MCP Compatible: Works with Claude Desktop and other MCP clients
• 🏢 Corporate Friendly: No external data sharing when using Bedrock mode

Quick Claude Code Integration

# Install both tools
npm install -g @anthropic-ai/claude-code vibex-task-manager

# Start developing with Claude Code backend
vibex-dev --claude-code "Help me build a user authentication system"

# Run integration examples
./examples/claude-code-integration.sh

Evolution Roadmap

✅ Phase 1 Complete: Claude Code integration and MCP compatibility 🔄 Phase 2 (Current): Enhanced UI and workflow automation 📋 Phase 3 (Next): Advanced Git workflows and testing automation 🚀 Phase 4 (Future): Multi-model orchestration and collaborative development

📖 Complete Integration Guide - Detailed setup and usage patterns 📖 Evolution Roadmap - Technical implementation timeline

🤖 Claude Integration

NEW: Seamlessly integrate with Claude Desktop and VS Code for AI-powered task management!

Quick Claude Desktop Setup

1. Install globally:

   npm install -g vibex-task-manager@latest

2. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

   {
     "mcpServers": {
       "vibex-task-manager": {
         "command": "npx",
         "args": ["vibex-task-manager@latest", "vibex", "mcp"],
         "env": {
           "AWS_REGION": "us-east-1",
           "AWS_PROFILE": "default"
         }
       }
     }
   }

3. Restart Claude Desktop and start managing tasks with natural language!

Example Claude Conversations

• "Show me all my current tasks" - Lists your tasks
• "Add a new task to implement user authentication" - Creates structured tasks
• "What should I work on next?" - Gets AI recommendations
• "Generate the implementation files for task T-001" - Creates code files
• "Analyze the complexity of my current tasks" - Provides detailed analysis

📖 Complete Claude Integration Guide - Detailed setup for Claude Desktop, VS Code, and command line workflows.

📚 Documentation

🎯 Getting Started

• Installation Guide - Complete installation instructions
• AWS Setup Guide - AWS Bedrock configuration
• Tutorial - Step-by-step walkthrough
• Auto-Detection - Automatic AWS model discovery

🛠️ Usage Guides

• CLI Reference - Complete command documentation
• Configuration - Project and global settings
• Task Structure - Understanding tasks and dependencies
• Examples - Real-world usage patterns

🔗 Integration

• MCP Tools - Model Context Protocol integration
• Platform Integrations - Editor and IDE setup
• Integration Examples - Practical scenarios

📖 Reference

• API Reference - Programming interfaces
• TypeScript API - TypeScript definitions
• Troubleshooting - Common issues and solutions
• Migration Guide - Migrating from other tools

⚡ Advanced

• SPARC Methodology - A structured workflow for complex tasks
• Agent Coordination - Multi-agent collaboration
• Memory System - Context preservation and learning

�� Common Use Cases

Individual Developers

# Break down a large feature into manageable tasks
vibex-task-manager parse-prd feature-spec.md --num-tasks 15

# Get AI assistance for complex tasks
vibex-task-manager expand --id 5 --research --prompt "Focus on security aspects"

# Track progress and get recommendations
vibex-task-manager next
vibex-task-manager analyze --research

AI Agent Teams

# Agent A: Claim and start working on a task
vibex-task-manager set-status --id 5 --status in-progress
vibex-task-manager update-task --id 5 --prompt "Implementing OAuth2 integration"

# Agent B: Find available work
vibex-task-manager next  # Gets next available task based on dependencies

# Agent C: Review and coordinate
vibex-task-manager list --status review
vibex-task-manager research --query "OAuth2 security best practices" --save-to 5.2

Development Teams

# Project manager: Set up project structure
vibex-task-manager init --name "E-commerce Platform"
vibex-task-manager parse-prd requirements.md --research

# Developer: Work on assigned tasks
vibex-task-manager show 5  # Get detailed task information
vibex-task-manager update-task --id 5 --append --prompt "Progress update: API endpoints completed"

# Reviewer: Quality assurance workflow
vibex-task-manager set-status --id 5 --status review
vibex-task-manager update-task --id 5 --append --prompt "Code review complete, ready for deployment"

Complex Problem-Solving with SPARC

# Enable SPARC for a complex task
vibex-task-manager sparc enable 7

# Generate requirements for the 'Specification' phase
vibex-task-manager sparc generate-requirements 7

# Advance to the 'Pseudocode' phase
vibex-task-manager sparc advance 7 pseudocode

# Generate pseudocode for the task
vibex-task-manager sparc generate-pseudocode 7

# ... continue through Architecture, Refinement, and Completion ...

# Validate the completed SPARC workflow
vibex-task-manager sparc validate 7

🚀 Why Vibex Task Manager?

🎯 Zero-Configuration AI

• Automatic AWS Bedrock model detection
• No API key management for multiple providers
• Intelligent model selection based on use case

🔒 Enterprise-Ready

• AWS-grade security and compliance
• Local data processing with cloud AI
• Granular access controls and audit trails

💰 Cost-Effective

• Pay-per-use AWS Bedrock pricing
• No subscription fees or monthly costs
• Transparent usage tracking

🤖 AI-Agent Optimized

• Built for multi-agent coordination
• Context preservation across sessions
• Intelligent conflict resolution

🌍 Global Scale

• AWS infrastructure worldwide
• Multi-region support
• High availability and performance

🛠️ Supported Environments

Operating Systems

• ✅ macOS (Intel & Apple Silicon)
• ✅ Windows (10/11)
• ✅ Linux (Ubuntu, Debian, CentOS, etc.)

Node.js Versions

• ✅ Node.js 18.x (LTS)
• ✅ Node.js 20.x (LTS)
• ✅ Node.js 22.x (Current)

AI Editors with MCP Support

• ✅ Cursor (recommended)
• ✅ Claude Code
• ✅ VS Code (with MCP extension)
• ✅ Windsurf
• ✅ Any MCP-compatible editor

AWS Bedrock Models

• Claude 3.5 Sonnet - Latest and most capable
• Claude 3 Opus - Best for complex reasoning
• Claude 3 Sonnet - Balanced performance
• Claude 3 Haiku - Fast and efficient

🔧 Configuration

AWS Credentials

Configure AWS access using any of these methods:

# AWS CLI (recommended)
aws configure

# Environment variables
export AWS_ACCESS_KEY_ID=your-key
export AWS_SECRET_ACCESS_KEY=your-secret
export AWS_DEFAULT_REGION=us-east-1

# AWS Profile
export AWS_PROFILE=your-profile

Project Configuration

Vibex Task Manager automatically creates a .vibex/ directory with:

• config.json - Project settings and model configurations
• tasks/tasks.json - Task data and relationships
• docs/research/ - AI research findings and cache
• reports/ - Complexity analysis and metrics

📊 Example Workflows

Project Initialization

# 1. Initialize with auto-detection
vibex-task-manager init

# 2. Parse requirements document
vibex-task-manager parse-prd requirements.md --num-tasks 20

# 3. Analyze and expand complex tasks
vibex-task-manager analyze --research
vibex-task-manager expand --all --force

# 4. Generate individual task files
vibex-task-manager generate

Daily Development

# 1. Get next recommended task
vibex-task-manager next

# 2. Start working on task
vibex-task-manager set-status --id 5 --status in-progress

# 3. Get AI assistance as needed
vibex-task-manager research --query "React hooks best practices" --save-to 5.2
vibex-task-manager update-task --id 5 --prompt "Implemented custom hooks for state management"

# 4. Complete and move to next
vibex-task-manager set-status --id 5 --status done
vibex-task-manager next

Team Coordination

# 1. Check team progress
vibex-task-manager list --format table

# 2. Review tasks needing attention
vibex-task-manager list --status review

# 3. Coordinate dependencies
vibex-task-manager validate-dependencies
vibex-task-manager add-dependency --id 7 --depends-on 5

# 4. Share research findings
vibex-task-manager research --query "API security checklist" --save-to-file

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone the repository
git clone https://github.com/sethdford/vibex-task-manager.git
cd vibex-task-manager

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Link for local development
npm link

📄 License

This project is licensed under an extremely permissive MIT License that explicitly allows commercial use, repackaging, and selling. See the LICENSE file for details.

Commercial Use Explicitly Permitted

• ✅ Use in commercial products
• ✅ Sell and redistribute
• ✅ Repackage and rebrand
• ✅ Integrate into proprietary software
• ✅ No attribution required in end products

🆘 Support

Documentation

• Complete Documentation - Comprehensive guides and references
• Troubleshooting Guide - Common issues and solutions
• FAQ - Frequently asked questions

Community Support

• GitHub Issues - Bug reports and feature requests
• Discussions - Community Q&A and best practices
• Examples - Real-world usage patterns and workflows

Enterprise Support

For enterprise deployments and custom integrations, contact us for professional support options.

🔄 Migration

From task-master-ai

Migrating from the legacy task-master-ai? We've got you covered:

# Update MCP configuration
# Replace "task-master-ai" with "vibex-task-manager" in your MCP config

# Run migration command
vibex-task-manager migrate

# The migration will:
# - Convert old .taskmaster/ directories to .vibex/
# - Update configuration format
# - Preserve all task data and relationships
# - Migrate to AWS Bedrock models

See the Migration Guide for detailed instructions.

🚀 What's Next?

1. Install Vibex Task Manager using your preferred method
2. Set up AWS Bedrock for AI capabilities
3. Follow the tutorial to learn the basics
4. Explore examples for your specific use case
5. Configure advanced features as needed

Transform your project management with AI-powered task management. Get started with Vibex Task Manager today!