Skip to content

supported-tools.md

Latest commit

 

History

History
105 lines (78 loc) · 5.24 KB

supported-tools.md

File metadata and controls

105 lines (78 loc) · 5.24 KB

Supported Tools

OpenSpec works with many AI coding assistants. When you run openspec init, OpenSpec configures selected tools using your active profile/workflow selection and delivery mode.

How It Works

For each selected tool, OpenSpec can install:

  1. Skills (if delivery includes skills): .../skills/openspec-*/SKILL.md
  2. Commands (if delivery includes commands): tool-specific opsx-* command files

By default, OpenSpec uses the core profile, which includes:

  • propose
  • explore
  • apply
  • archive

You can enable expanded workflows (new, continue, ff, verify, sync, bulk-archive, onboard) via openspec config profile, then run openspec update.

Tool Directory Reference

Tool (ID) Skills path pattern Command path pattern
Amazon Q Developer (amazon-q) .amazonq/skills/openspec-*/SKILL.md .amazonq/prompts/opsx-<id>.md
Antigravity (antigravity) .agent/skills/openspec-*/SKILL.md .agent/workflows/opsx-<id>.md
Auggie (auggie) .augment/skills/openspec-*/SKILL.md .augment/commands/opsx-<id>.md
Claude Code (claude) .claude/skills/openspec-*/SKILL.md .claude/commands/opsx/<id>.md
Cline (cline) .cline/skills/openspec-*/SKILL.md .clinerules/workflows/opsx-<id>.md
CodeBuddy (codebuddy) .codebuddy/skills/openspec-*/SKILL.md .codebuddy/commands/opsx/<id>.md
Codex (codex) .codex/skills/openspec-*/SKILL.md $CODEX_HOME/prompts/opsx-<id>.md*
Continue (continue) .continue/skills/openspec-*/SKILL.md .continue/prompts/opsx-<id>.prompt
CoStrict (costrict) .cospec/skills/openspec-*/SKILL.md .cospec/openspec/commands/opsx-<id>.md
Crush (crush) .crush/skills/openspec-*/SKILL.md .crush/commands/opsx/<id>.md
Cursor (cursor) .cursor/skills/openspec-*/SKILL.md .cursor/commands/opsx-<id>.md
Factory Droid (factory) .factory/skills/openspec-*/SKILL.md .factory/commands/opsx-<id>.md
Gemini CLI (gemini) .gemini/skills/openspec-*/SKILL.md .gemini/commands/opsx/<id>.toml
GitHub Copilot (github-copilot) .github/skills/openspec-*/SKILL.md .github/prompts/opsx-<id>.prompt.md**
iFlow (iflow) .iflow/skills/openspec-*/SKILL.md .iflow/commands/opsx-<id>.md
Kilo Code (kilocode) .kilocode/skills/openspec-*/SKILL.md .kilocode/workflows/opsx-<id>.md
Kiro (kiro) .kiro/skills/openspec-*/SKILL.md .kiro/prompts/opsx-<id>.prompt.md
OpenCode (opencode) .opencode/skills/openspec-*/SKILL.md .opencode/commands/opsx-<id>.md
Pi (pi) .pi/skills/openspec-*/SKILL.md .pi/prompts/opsx-<id>.md
Qoder (qoder) .qoder/skills/openspec-*/SKILL.md .qoder/commands/opsx/<id>.md
Qwen Code (qwen) .qwen/skills/openspec-*/SKILL.md .qwen/commands/opsx-<id>.toml
RooCode (roocode) .roo/skills/openspec-*/SKILL.md .roo/commands/opsx-<id>.md
Trae (trae) .trae/skills/openspec-*/SKILL.md Not generated (no command adapter; use skill-based /openspec-* invocations)
Windsurf (windsurf) .windsurf/skills/openspec-*/SKILL.md .windsurf/workflows/opsx-<id>.md

* Codex commands are installed in the global Codex home ($CODEX_HOME/prompts/ if set, otherwise ~/.codex/prompts/), not your project directory.

** GitHub Copilot prompt files are recognized as custom slash commands in IDE extensions (VS Code, JetBrains, Visual Studio). Copilot CLI does not currently consume .github/prompts/*.prompt.md directly.

Non-Interactive Setup

For CI/CD or scripted setup, use --tools (and optionally --profile):

# Configure specific tools
openspec init --tools claude,cursor

# Configure all supported tools
openspec init --tools all

# Skip tool configuration
openspec init --tools none

# Override profile for this init run
openspec init --profile core

Available tool IDs (--tools): amazon-q, antigravity, auggie, claude, cline, codex, codebuddy, continue, costrict, crush, cursor, factory, gemini, github-copilot, iflow, kilocode, kiro, opencode, pi, qoder, qwen, roocode, trae, windsurf

Workflow-Dependent Installation

OpenSpec installs workflow artifacts based on selected workflows:

  • Core profile (default): propose, explore, apply, archive
  • Custom selection: any subset of all workflow IDs: propose, explore, new, continue, apply, ff, sync, archive, bulk-archive, verify, onboard

In other words, skill/command counts are profile-dependent and delivery-dependent, not fixed.

Generated Skill Names

When selected by profile/workflow config, OpenSpec generates these skills:

  • openspec-propose
  • openspec-explore
  • openspec-new-change
  • openspec-continue-change
  • openspec-apply-change
  • openspec-ff-change
  • openspec-sync-specs
  • openspec-archive-change
  • openspec-bulk-archive-change
  • openspec-verify-change
  • openspec-onboard

See Commands for command behavior and CLI for init/update options.

Related