Command

Install the `@scopecraft/cmd` package globally so the `sc` CLI and `scopecraft-stdio` MCP server binary are available system-wide.

npm install -g @scopecraft/cmd
# or with bun:
bun install -g @scopecraft/cmd

Scopecraft stores tasks as Markdown files in a `.tasks/` directory within your project. Set the `SCOPECRAFT_ROOT` environment variable to your project directory, or pass `--root-dir` at runtime.

export SCOPECRAFT_ROOT=/path/to/your/project
# Verify CLI works:
sc task list

Test the CLI by creating a task. Scopecraft will write a structured Markdown file into the `.tasks/` directory.

sc task create --title "Set up authentication" --type feature

Register the `scopecraft-stdio` MCP server in your Claude Desktop config. Pass `--root-dir` to point it at the correct project directory.

{
  "mcpServers": {
    "scopecraft": {
      "command": "npx",
      "args": ["--package=@scopecraft/cmd", "scopecraft-stdio", "--root-dir", "/path/to/your/project"]
    }
  }
}

For teams with multiple projects, create `~/.scopecraft/config.json` with a `projects` object mapping names to directory paths.

{
  "projects": {
    "my-api": "/home/user/projects/my-api",
    "frontend": "/home/user/projects/frontend"
  }
}

Restart your MCP client. Claude now has access to task management tools and can create, list, update, and complete tasks in your project's `.tasks/` directory through natural conversation.