speck

Local-first OpenSpec orchestration and UI.

Install

Homebrew (recommended)

brew tap andremonaco/speck
brew install speck

Curl installer

curl -fsSL https://raw.githubusercontent.com/andremonaco/speck/main/scripts/curl-install.sh | sh

Run

speck

Development

scripts/dev-install.sh --install
deno task ui

Commit messages

Commit messages follow Conventional Commits (commitizen style). The commit-msg hook enforces this via commitlint.

Release workflow

• Releases are cut via GitHub Actions on merged PRs to main using conventional commits.
• Required secrets:
  • HOMEBREW_TAP_TOKEN: PAT with contents:write access to andremonaco/homebrew-speck.
  • CODECOV_TOKEN (optional): enables coverage uploads to Codecov.
• Recommended: enable branch protection so CI/CD must pass and PRs require approval before merge.