@specd/cli

The command-line interface for specd — a spec-driven development platform. For more information, visit getspecd.dev. Provides commands for managing the full change lifecycle, browsing specs, inspecting configuration and schemas, and managing agent skills.

Installation

pnpm add -g @specd/cli

Or run directly via pnpm within the monorepo:

pnpm specd --help

Quick Start

Initialize a new specd project:

specd project init

This creates specd.yaml in the current directory and scaffolds the workspace layout.

Basic change workflow:

# Create a change and associate it with specs
specd change create add-auth-flow --spec auth/login --spec auth/logout

# Check its status at any point
specd change status add-auth-flow

# Advance to the next lifecycle state
specd change transition add-auth-flow --next

# Approve at a lifecycle gate
specd change approve spec add-auth-flow --reason "Meets requirements"

# Archive once work is complete
specd change archive add-auth-flow

Invoke with no subcommand — if a specd.yaml is discoverable from the current directory, the project dashboard is shown automatically.

Command Groups

| Group | Description | | ----------- | -------------------------------------------------------------------------------------------- | | change | Create, list, inspect, and progress changes through the lifecycle. Core day-to-day commands. | | drafts | Browse and restore changes that have been shelved with change draft. | | discarded | List and inspect changes that were discarded. | | archive | Browse changes that have been archived (completed work). | | spec | List, show, validate, and manage spec files. | | project | Initialize and inspect the specd project (init, context, update, dashboard). | | config | Inspect the resolved project configuration. | | schema | Introspect, fork, extend, and validate schemas. | | skills | List, install, and update agent skills. | | graph | Code graph intelligence: index, search, impact analysis, hotspots. |

Global Options

| Option | Description | | --------------------------- | --------------------------------------------------------------------------------------------------------- | | --config <path> | Use this config file directly. Skips normal file discovery. Applies to all subcommands. | | --format text\|json\|toon | Output format. text is the default; json is suitable for scripting; toon is a rich terminal format. |

Output Formats

• text — human-readable tables and prose (default for interactive use)
• json — structured output suitable for piping into other tools or scripts
• toon — rich, styled terminal output using the toon format

Switch format per-command:

specd change list --format json
specd change status add-auth-flow --format toon

Full Reference

See docs/cli/cli-reference.md for detailed documentation of every command, option, and example.