sp ec

sp ec installs a shared .sp/ working area and slash commands that guide a coding agent from a constitution and feature specification through planning, tasks, analysis, and implementation.

Install

Run from a repository root:

sp ec install

The installer detects supported coding agents from their project configuration. Choose one explicitly when detection is not possible:

sp ec install --agent claude
sp ec install --agent cursor
sp ec install --agent copilot
sp ec install --agent gemini
sp ec install --agent opencode
sp ec install --all

The installed repository contains:

.sp/
  memory/constitution.md
  scripts/
  templates/

Generated scripts, templates, and run state are added to .gitignore. .sp/memory/constitution.md remains trackable and is never overwritten by --force.

Commands

The coding-agent command directory receives:

Workspaces and huddles

Point --dir at a folder of Git repositories to install each repository independently:

sp ec install --dir path/to/workspace

Each detected repository gets its own .sp/ area and repo-scoped commands. The workspace root gets /huddle, which coordinates one initiative across multiple repositories while keeping each repository's specification, plan, and tasks in that repository.

Huddles are Markdown documents under:

.sp/huddles/NNN-short-name/huddle.md

Markdown is always the source of truth. Remote synchronization never prevents a local huddle from being written.

Diagnose integrations

sp ec doctor

The doctor reports:

• the configured huddle store;
• GitHub CLI authentication and access to the configured GitHub Project;
• whether a Linear MCP configuration or LINEAR_API_KEY is visible;
• an actionable setup command for each missing capability.

Configure work management

Run guided setup:

sp ec project setup

Or configure it without prompts:

sp ec project setup \
  --provider github \
  --url https://github.com/orgs/example/projects/1
 
sp ec project setup \
  --provider linear \
  --url https://linear.app/example \
  --team Engineering \
  --transport mcp

GitHub Projects can be checked and synchronized directly:

sp ec project status
sp ec project sync .sp/huddles/001-example/huddle.md --dry-run
sp ec project sync .sp/huddles/001-example/huddle.md

Each GitHub draft item carries a stable huddle-path marker. Repeated syncs update the existing item instead of creating duplicates. /huddle prefers available GitHub MCP project tools and falls back to the gh CLI sync command.

Linear setup records the workspace, team, and preferred transport. sp ec doctor then tells the user whether the configured agent exposes Linear MCP or whether an API key is available.

Install options