Installation
The binary is named ds.
macOS and Linux
brew install devspecs-com/tap/devspecs
or:
curl -fsSL https://raw.githubusercontent.com/devspecs-com/devspecs-cli/main/install.sh | sh
Windows
scoop bucket add devspecs https://github.com/devspecs-com/scoop-bucket
scoop install devspecs
or:
irm https://raw.githubusercontent.com/devspecs-com/devspecs-cli/main/install.ps1 | iex
Go
go install github.com/devspecs-com/devspecs-cli/cmd/ds@latest
After installing, restart your terminal or IDE if ds still resolves to an old
binary.
First Run
From a Git repository:
ds init
ds task "your bounded goal"
ds init creates local DevSpecs state, repo config, and optional agent adapter
files for Codex, Cursor, Claude, or Windsurf. It can index in the background.
For non-interactive setup:
ds init --yes --tool codex,cursor,claude,windsurf
Current generated entry points are thin files over the same CLI flow:
| Tool target | Generated files | Entry points |
|---|---|---|
| Codex/generic agents | .agents/skills/ds-task/SKILL.md, .agents/skills/ds-apply/SKILL.md | $ds-task, $ds-apply |
| Cursor | .cursor/commands/ds-task.md, .cursor/commands/ds-apply.md | /ds-task, /ds-apply |
| Claude | .claude/skills/ds-task/SKILL.md, .claude/skills/ds-apply/SKILL.md | /ds-task, /ds-apply |
| Windsurf | .windsurf/workflows/ds-task.md, .windsurf/workflows/ds-apply.md | /ds-task, /ds-apply |
These files do not run agents autonomously. They route the agent back through
ds task, ds apply, and ds task checkpoint.
When the task is already clear, use ds task first. When you need orientation
before choosing the task, use:
ds map
ds recent
ds find "topic"
Updating
ds update
ds update checks the latest release and prints package-manager-aware update
guidance. It does not replace package-manager-owned binaries itself.