Scopecraft Command

A powerful command-line tool and MCP server for managing Markdown-Driven Task Management (MDTM) files. Scopecraft helps you organize tasks, features, and development workflows with a structured approach.

Version 2.0: Now with two-state workflow (current/archive) and phase-based organization, parent tasks for complex features, and advanced subtask sequencing capabilities!

Key Features:

• Works with any AI IDE (Cursor, Claude Desktop, etc.) via flexible project root configuration
• Two-state workflow with phase-based task organization (current/archive + phase metadata)
• Parent tasks with subtask sequencing and parallel execution
• Supports MDTM format with TOML/YAML frontmatter
• Provides both CLI and MCP server interfaces
• Includes specialized Claude commands for feature development
• Automated project type detection
• Multi-project support with easy switching

Installation

Install from NPM

Global Installation (Recommended)

# Install globally with npm
npm install -g @scopecraft/cmd

# Or with yarn
yarn global add @scopecraft/cmd

# Or with bun
bun install -g @scopecraft/cmd

After installation, these commands will be available:

• scopecraft / sc - CLI for task management
• scopecraft-mcp / sc-mcp - MCP server (HTTP/SSE)
• scopecraft-stdio / sc-stdio - MCP server (STDIO transport)

Using with npx (No Installation)

# Run CLI commands directly
npx @scopecraft/cmd sc task list
npx @scopecraft/cmd sc feature create "New Feature"

# Run MCP STDIO server
npx --package=@scopecraft/cmd scopecraft-stdio --root-dir /path/to/your/project

Install from Source

# Clone repository
git clone https://github.com/scopecraft-ai/scopecraft-command.git
cd scopecraft-command

# Install dependencies
bun install

# Build project
bun run build

# Install globally
bun run install:global

Project Root Configuration

Scopecraft now works with any AI IDE! Configure your project root using one of these methods:

Quick Setup for AI IDEs

Cursor / Claude Desktop

# Start MCP server with your project
scopecraft-mcp --root-dir /path/to/your/project

Or add to your IDE's MCP configuration:

{
  "scopecraft": {
    "command": "scopecraft-mcp",
    "args": ["--root-dir", "/path/to/your/project"]
  }
}

Multiple Projects

Create ~/.scopecraft/config.json:

{
  "projects": {
    "frontend": { "path": "/projects/myapp/frontend" },
    "backend": { "path": "/projects/myapp/backend" }
  }
}

Then switch projects at runtime:

init_root /projects/myapp/backend

Configuration Methods

1. CLI Parameter: --root-dir /path/to/project
2. MCP Command: init_root /path/to/project
3. Config File: ~/.scopecraft/config.json
4. Environment: SCOPECRAFT_ROOT=/path/to/project

See Project Root Configuration Guide for detailed setup instructions.

Getting Started

# Initialize Scopecraft in your project
sc init

# Create your first task
sc task create --title "My first feature" --type feature

# List your tasks
sc task list

Quick Start

Basic Task Management

# List all tasks
sc task list
sc task list --current    # Show only active tasks  
sc task list --phase backlog  # Show backlog items by phase

# Create a new task (goes to current with phase=backlog by default)
sc task create --title "Implement user authentication" --type feature

# Update task status
sc task update TASK-123 --status "In Progress"
sc task start TASK-123    # Shortcut for marking as "In Progress"
sc task complete TASK-123 # Shortcut for marking as "Done"

# View task details
sc task get TASK-123

Parent Tasks (Complex Features)

# Create a parent task with subtasks
sc parent create --title "User Authentication" --type feature

# Add subtasks to a parent
sc parent add-subtask auth-05K --title "Design login UI"
sc parent add-subtask auth-

... [View full README on GitHub](https://github.com/scopecraft/command#readme)