taskwerk/src/cli/index.js

A task management CLI for developers and AI agents working together

import { Command } from 'commander';
import { aboutCommand } from '../commands/about.js';
import { initCommand } from '../commands/init.js';
import { statusCommand } from '../commands/status.js';
import { configCommand } from '../commands/config.js';
import { exportCommand } from '../commands/export.js';
import { importCommand } from '../commands/import.js';
import { aiconfigCommand } from '../commands/aiconfig.js';
import { llmCommand } from '../commands/llm.js';
import { askCommand } from '../commands/ask.js';
import { agentCommand } from '../commands/agent.js';
import { contextCommand } from '../commands/context/index.js';
// Import individual task commands directly
import { taskAddCommand } from '../commands/task/add.js';
import { taskListCommand } from '../commands/task/list.js';
import { taskShowCommand } from '../commands/task/show.js';
import { taskUpdateCommand } from '../commands/task/update.js';
import { taskDeleteCommand } from '../commands/task/delete.js';
import { taskStatusCommand } from '../commands/task/status.js';
import { taskSplitCommand } from '../commands/task/split.js';
import { ErrorHandler } from '../errors/index.js';
import packageInfo from '../version.js';

const program = new Command();

program
  .name(packageInfo.name)
  .description(packageInfo.description)
  .version(packageInfo.version)
  .helpOption('-h, --help', 'Display help for command')
  .addHelpCommand('help [command]', 'Display help for command')
  .option('--verbose-error', 'Output detailed error information in JSON format for automation')
  .addHelpText(
    'after',
    `
Quick Start:
  $ twrk init                              # Initialize taskwerk in current directory
  $ twrk addtask "Fix login bug"           # Create your first task
  $ twrk list                              # View all tasks
  $ twrk showtask 1                        # Show details for task 1

Common Workflows:
  Task Management:
    $ twrk addtask "New feature" -p high -a @john
    $ twrk updatetask 1 -s in-progress
    $ twrk done 1                          # Mark task as done
    
  Search & Filter:
    $ twrk list --search "authentication"  # Find tasks mentioning auth
    $ twrk list --search "bug" -p high     # Find high priority bugs
    $ twrk list --search "TODO" -s in-progress # Find in-progress TODOs
    
  Task Splitting:
    $ twrk splittask 1 -n "Backend" "Frontend" # Quick split into 2 tasks
    $ twrk splittask 1 --divide-estimate   # Interactive with estimates
    $ twrk splittask 1 -i                  # Full interactive mode
    
  AI/LLM Integration:
    $ twrk ask "What are my high priority tasks?"  # Query about tasks
    $ twrk agent "Create subtasks for task 1"      # Make changes
    $ twrk export -t 1 2 3 --stdout | pbcopy      # Copy tasks to clipboard
    $ twrk updatetask 1 -a @ai-agent              # Assign to AI
    $ twrk export -a @ai-agent -o ai-tasks.md     # Export AI's tasks
    
  AI Chat Context (New!):
    • In projects: Conversations are maintained per-project automatically
    • Outside projects: Uses global context or named contexts
    $ twrk ask "What did we discuss earlier?"  # Continues previous chat
    $ twrk ask --context work "Track this idea" # Named global context
    $ twrk ask --new "Start fresh topic"       # Force new conversation
    
  Bulk Operations:
    $ twrk export -s todo                          # Export all todo tasks
    $ twrk list -s blocked --format json       # List blocked tasks as JSON

Key Features:
  • Fuzzy ID matching: Use '1' instead of 'TASK-001'
  • Case-insensitive: 'task-1', 'TASK-1', 'Task-1' all work
  • Rich markdown export perfect for LLMs
  • Subtask support with parent-child relationships
  • Comprehensive tagging and filtering
  • AI Chat Context: Conversations are maintained per-project or globally

For more help:
  $ twrk <command> --help                  # Detailed help for any command
  $ twrk about                             # Learn more about taskwerk

Tip: Task IDs support fuzzy matching - just use the number!`
  )
  .hook('preAction', thisCommand => {
    // Set up error handling before any command executes
    process.on('uncaughtException', error => {
      ErrorHandler.handle(error, thisCommand.name());
    });
    process.on('unhandledRejection', error => {
      ErrorHandler.handle(error, thisCommand.name());
    });
  })
  .configureHelp({
    sortSubcommands: true,
  });

// Add all commands
program.addCommand(aboutCommand());
program.addCommand(initCommand());
program.addCommand(statusCommand());
program.addCommand(configCommand());
program.addCommand(exportCommand());
program.addCommand(importCommand());
program.addCommand(aiconfigCommand());
program.addCommand(llmCommand());
program.addCommand(askCommand());
program.addCommand(agentCommand());
program.addCommand(contextCommand());

// Add task commands as root-level commands with 'task' suffix
const addTask = taskAddCommand();
addTask.name('addtask');
program.addCommand(addTask);

// Add 'list' as the primary command
const listCommand = taskListCommand();
listCommand.name('list');
program.addCommand(listCommand);

// Add 'listtask' as an alias for backwards compatibility (hidden from help)
const listTask = taskListCommand();
listTask.name('listtask');
listTask.hidden = true;
program.addCommand(listTask);

// Add 'listtasks' as another alias
const listTasks = taskListCommand();
listTasks.name('listtasks');
listTasks.description('List tasks (alias for "list")');
program.addCommand(listTasks);

const showTask = taskShowCommand();
showTask.name('showtask');
program.addCommand(showTask);

const updateTask = taskUpdateCommand();
updateTask.name('updatetask');
program.addCommand(updateTask);

const deleteTask = taskDeleteCommand();
deleteTask.name('deletetask');
program.addCommand(deleteTask);

const statusTask = taskStatusCommand();
statusTask.name('statustask');
program.addCommand(statusTask);

const splitTask = taskSplitCommand();
splitTask.name('splittask');
program.addCommand(splitTask);

// Add search alias command
program
  .command('search <term>')
  .description('Search tasks by name, description, or content')
  .option('-s, --status <status>', 'Filter by status')
  .option('-a, --assignee <name>', 'Filter by assignee')
  .option('-p, --priority <level>', 'Filter by priority')
  .option('-t, --tags <tags...>', 'Filter by tags')
  .option('--format <format>', 'Output format', 'table')
  .addHelpText(
    'after',
    `
Examples:
  $ twrk search "authentication"     # Find tasks mentioning auth
  $ twrk search "bug" -p high        # Find high priority bugs
  $ twrk search "TODO" -s in-progress # Find in-progress TODOs
  
This is a shortcut for: twrk list --search <term>`
  )
  .action(async (term, options) => {
    const listCmd = taskListCommand();
    const args = ['--search', term];
    if (options.status) {
      args.push('-s', options.status);
    }
    if (options.assignee) {
      args.push('-a', options.assignee);
    }
    if (options.priority) {
      args.push('-p', options.priority);
    }
    if (options.tags) {
      args.push('-t');
      args.push(...options.tags);
    }
    if (options.format) {
      args.push('--format', options.format);
    }
    await listCmd.parseAsync(args, { from: 'user' });
  });

// Add quick status commands
program
  .command('done <id>')
  .description('Mark a task as done')
  .addHelpText(
    'after',
    `
Examples:
  $ twrk done 1                    # Mark task 1 as done
  $ twrk done TASK-001             # Use full ID
  $ twrk done task-5               # Case-insensitive
  
This is a shortcut for: twrk statustask <id> done`
  )
  .action(async id => {
    const cmd = taskStatusCommand();
    await cmd.parseAsync([id, 'done'], { from: 'user' });
  });

program
  .command('start <id>')
  .description('Mark a task as in-progress')
  .addHelpText(
    'after',
    `
Examples:
  $ twrk start 1                   # Start working on task 1
  $ twrk start TASK-001            # Use full ID
  $ twrk start 5                   # Fuzzy matching works
  
This is a shortcut for: twrk statustask <id> in-progress`
  )
  .action(async id => {
    const cmd = taskStatusCommand();
    await cmd.parseAsync([id, 'in-progress'], { from: 'user' });
  });

program
  .command('block <id>')
  .description('Mark a task as blocked')
  .addHelpText(
    'after',
    `
Examples:
  $ twrk block 1                   # Mark task 1 as blocked
  $ twrk block TASK-001            # Use full ID
  $ twrk block 3                   # Quick blocking
  
This is a shortcut for: twrk statustask <id> blocked
Tip: Use 'twrk statustask <id> blocked --note "reason"' to add context`
  )
  .action(async id => {
    const cmd = taskStatusCommand();
    await cmd.parseAsync([id, 'blocked'], { from: 'user' });
  });

program.parse(process.argv);