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)