specscore-cli

module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 22, 2026 License: Apache-2.0

README

specscore-cli

CLI for SpecScore — lint, query, and scaffold SpecScore specifications.

Install

macOS / Linux — curl
curl -fsSL https://specscore.md/install/get-cli | sh
Windows — PowerShell
powershell -c "irm https://specscore.md/install/get-cli.ps1 | iex"
macOS — Homebrew
brew install synchestra-io/tap/specscore
Windows — Scoop / WinGet
scoop bucket add synchestra-io https://github.com/synchestra-io/scoop-bucket
scoop install specscore
# or
winget install Synchestra.SpecScore

See installation docs for options (version pinning, custom install dir).

Usage

specscore spec lint              # lint the current spec tree
specscore feature list           # list features
specscore feature show <slug>    # inspect a feature
specscore task list              # show the task board
specscore version                # full build identity
specscore --version              # bare semver

Full command reference: see spec/features/cli/.

AI skills

If you drive specscore from inside Claude Code (or any agent host that loads Claude Code plugins), install the ai-plugin-specscore plugin. It ships agent skills that wrap each CLI resource group — they teach the agent when to call which command, which flags to pass, and how to interpret exit codes, all grounded in the feature specs in this repo.

/plugin marketplace add synchestra-io/ai-marketplace
/plugin install specscore@synchestra-io

Then bootstrap the CLI itself with /specscore:install, or install manually with the one-liner above.

License

Apache License 2.0 — see LICENSE.

Directories

Path Synopsis
cmd
specscore command
internal
cli
telemetry
Package telemetry is the single audit surface for all telemetry transmission from the specscore CLI.
Package telemetry is the single audit surface for all telemetry transmission from the specscore CLI.
pkg
exitcode
Package exitcode defines the shared exit code constants and error type used by all SpecScore CLI commands and library consumers.
Package exitcode defines the shared exit code constants and error type used by all SpecScore CLI commands and library consumers.
feature
Package feature provides feature discovery, traversal, metadata, dependency resolution, and scaffolding.
Package feature provides feature discovery, traversal, metadata, dependency resolution, and scaffolding.
gitremote
Package gitremote parses git remote URLs into their owner / repo / host components.
Package gitremote parses git remote URLs into their owner / repo / host components.
idea
Package idea parses and represents SpecScore Idea artifacts.
Package idea parses and represents SpecScore Idea artifacts.
idearelocate
Package idearelocate implements cross-repo relocation of Idea and sidekick-seed artifacts per spec/features/cli/idea/relocate/README.md.
Package idearelocate implements cross-repo relocation of Idea and sidekick-seed artifacts per spec/features/cli/idea/relocate/README.md.
lifecycle
Package lifecycle hosts a kind-parameterized state machine for SpecScore artifact Status transitions.
Package lifecycle hosts a kind-parameterized state machine for SpecScore artifact Status transitions.
lint
specscore:feature/cli/spec/lint
specscore:feature/cli/spec/lint
plan
Package plan parses single-file Plan artifacts at spec/plans/<slug>.md per the SpecStudio plan-Feature contract (https://github.com/synchestra-io/specstudio-skills/blob/main/spec/features/skills/plan/README.md).
Package plan parses single-file Plan artifacts at spec/plans/<slug>.md per the SpecStudio plan-Feature contract (https://github.com/synchestra-io/specstudio-skills/blob/main/spec/features/skills/plan/README.md).
projectdef
Package projectdef provides the specscore.yaml schema and read/write operations defined by the SpecScore Repo Config feature (https://specscore.md/repo-config).
Package projectdef provides the specscore.yaml schema and read/write operations defined by the SpecScore Repo Config feature (https://specscore.md/repo-config).
task
Package task defines the canonical task types, status enum, and related structures used by all SpecScore-based coordination tools.
Package task defines the canonical task types, status enum, and related structures used by all SpecScore-based coordination tools.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL