Skip to main content

​
Agent Support Matrix

Spec Kit supports 15+ AI coding agents with built-in integration. Each agent is configured with the appropriate directory structure, command format, and invocation patterns.
If your preferred agent isn’t listed, you can use the Generic option with --ai generic --ai-commands-dir <path> to bring your own agent.

​
CLI-Based Agents

These agents require command-line tool installation and can be invoked from the terminal.

Claude Code

Anthropic’s Claude Code
  • CLI Tool: claude
  • Directory: .claude/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai claude

Gemini CLI

Google’s Gemini CLI
  • CLI Tool: gemini
  • Directory: .gemini/commands/
  • Format: TOML (.toml)
  • Status: ✅ Fully Supported
specify init my-project --ai gemini

opencode

opencode AI Assistant
  • CLI Tool: opencode
  • Directory: .opencode/command/ (singular)
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai opencode

Auggie CLI

Augment’s Auggie CLI
  • CLI Tool: auggie
  • Directory: .augment/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai auggie

Codex CLI

OpenAI’s Codex CLI
  • CLI Tool: codex
  • Directory: .codex/prompts/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai codex

Amazon Q Developer CLI

AWS Amazon Q Developer
  • CLI Tool: q
  • Directory: .amazonq/prompts/
  • Format: Markdown (.md)
  • Status: ⚠️ Partial Support
  • Note: Does not support custom arguments for slash commands (issue #3064)
specify init my-project --ai q

Amp

Amp Code Assistant
  • CLI Tool: amp
  • Directory: .agents/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai amp

SHAI

OVHcloud’s SHAI
  • CLI Tool: shai
  • Directory: .shai/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai shai

CodeBuddy CLI

CodeBuddy Assistant
  • CLI Tool: codebuddy
  • Directory: .codebuddy/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai codebuddy

Qoder CLI

Qoder Code Assistant
  • CLI Tool: qodercli
  • Directory: .qoder/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai qodercli

Qwen Code

Alibaba’s Qwen Code
  • CLI Tool: qwen
  • Directory: .qwen/commands/
  • Format: TOML (.toml)
  • Status: ✅ Fully Supported
specify init my-project --ai qwen

​
IDE-Based Agents

These agents are built into integrated development environments and don’t require separate CLI installation.

GitHub Copilot

GitHub Copilot in VS Code
  • CLI Tool: N/A (IDE-based)
  • Directory: .github/agents/
  • Format: Markdown (.agent.md) with mode field
  • Status: ✅ Fully Supported
specify init my-project --ai copilot

Cursor

Cursor Editor
  • CLI Tool: cursor-agent (optional)
  • Directory: .cursor/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai cursor-agent

Windsurf

Windsurf IDE
  • CLI Tool: N/A (IDE-based)
  • Directory: .windsurf/workflows/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai windsurf

Kilo Code

Kilo Code IDE
  • CLI Tool: N/A (IDE-based)
  • Directory: .kilocode/workflows/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai kilocode

Roo Code

Roo Code Assistant
  • CLI Tool: N/A (IDE-based)
  • Directory: .roo/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai roo

IBM Bob

IBM Bob Assistant
  • CLI Tool: N/A (IDE-based)
  • Directory: .bob/commands/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
  • Note: IDE-based agent with slash command support
specify init my-project --ai bob

Antigravity

Antigravity (agy)
  • CLI Tool: N/A (IDE-based)
  • Directory: .agent/workflows/
  • Format: Markdown (.md)
  • Status: ✅ Fully Supported
specify init my-project --ai agy

​
Generic Agent Support

Bring your own agent by specifying a custom commands directory.

Generic / Custom Agent

Custom AI Agent Integration
  • CLI Tool: N/A (user-provided)
  • Directory: User-specified via --ai-commands-dir
  • Format: Markdown (.md)
  • Status: ✅ Supported
  • Use Case: For agents not officially supported or custom agent implementations
specify init my-project --ai generic --ai-commands-dir .myagent/commands/
The generic option creates standard Markdown command files in your specified directory. Ensure your agent can discover and execute commands from that location.

​
Available Slash Commands

All agents receive these standardized slash commands when initialized:

​
Core Workflow Commands

CommandDescriptionWhen to Use
/speckit.constitutionCreate/update project principlesAt project start to establish guidelines
/speckit.specifyDefine feature requirementsFor each new feature specification
/speckit.planCreate technical implementation plansAfter spec is clarified and approved
/speckit.tasksGenerate task breakdownsBefore implementation to plan work
/speckit.implementExecute all tasks systematicallyTo build the feature per the plan

​
Quality & Validation Commands

CommandDescriptionWhen to Use
/speckit.clarifyStructured requirement clarificationBefore planning to resolve ambiguities
/speckit.analyzeCross-artifact consistency analysisAfter tasks, before implementation
/speckit.checklistGenerate quality checklistsTo validate requirement completeness
/speckit.taskstoissuesConvert tasks to GitHub issuesFor project management tracking

​
Installation Quick Reference

# Install Claude Code CLI
# Visit: https://docs.anthropic.com/en/docs/claude-code/setup

# Initialize project
specify init my-project --ai claude

# With agent skills
specify init my-project --ai claude --ai-skills

​
Checking Installed Tools

Verify which AI agent tools are installed on your system: 
specify check
This command checks for:
  • Git (required)
  • Claude Code (claude)
  • Gemini CLI (gemini)
  • VS Code (code or code-insiders)
  • Cursor (cursor-agent)
  • Qwen Code (qwen)
  • opencode (opencode)
  • Codex CLI (codex)
  • SHAI (shai)
  • Qoder CLI (qodercli)
  • And other supported CLI tools
Some agents are IDE-based and won’t appear in the tool check. This is normal for agents like GitHub Copilot, Windsurf, IBM Bob, and Kilo Code.

​
Next Steps

Configuration Guide

Learn how to configure and customize agent integration for your project

Agent Overview

Understand the concepts behind agent integration and the spec-driven workflow

Build docs developers (and LLMs) love

Get started for freeTalk to us