Table of Contents

Supported AI Agents Reference

Spec Kitty supports 12 AI coding agents with slash commands. This document lists all supported agents and their configuration details.

Agent Overview

Agent Directory Commands Subdirectory Slash Commands
Claude Code .claude/ commands/ /spec-kitty.*
GitHub Copilot .github/ prompts/ /spec-kitty.*
Google Gemini .gemini/ commands/ /spec-kitty.*
Cursor .cursor/ commands/ /spec-kitty.*
Qwen Code .qwen/ commands/ /spec-kitty.*
OpenCode .opencode/ command/ /spec-kitty.*
Windsurf .windsurf/ workflows/ /spec-kitty.*
GitHub Codex .codex/ prompts/ /spec-kitty.*
Kilocode .kilocode/ workflows/ /spec-kitty.*
Auggie CLI .augment/ commands/ /spec-kitty.*
Roo Cline .roo/ commands/ /spec-kitty.*
Amazon Q .amazonq/ prompts/ /spec-kitty.*

Managing Active Agents

Spec-kitty supports 12 AI agents (listed above). You can activate or deactivate agents at any time using the spec-kitty agent config command family.

To manage which agents are active in your project:

  • View configured agents: spec-kitty agent config list
  • Add agents: spec-kitty agent config add <agents>
  • Remove agents: spec-kitty agent config remove <agents>

See Managing AI Agents for complete documentation on agent management workflows.

Agent Details

Claude Code

Primary supported agent — Full feature support and extensive testing.

Property Value
Directory .claude/
Commands subdirectory commands/
CLI flag --ai claude
Status Fully supported

Features:

  • Full slash command support
  • Custom command arguments
  • Project-level CLAUDE.md integration
  • Best documentation and testing coverage

Usage:

spec-kitty init my-project --ai claude
cd my-project
claude  # Launch Claude Code
/spec-kitty.specify Add user authentication

GitHub Copilot

Property Value
Directory .github/
Commands subdirectory prompts/
CLI flag --ai copilot
Status Supported

Usage:

spec-kitty init my-project --ai copilot

Google Gemini

Property Value
Directory .gemini/
Commands subdirectory commands/
CLI flag --ai gemini
Status Supported

Usage:

spec-kitty init my-project --ai gemini

Cursor

Property Value
Directory .cursor/
Commands subdirectory commands/
CLI flag --ai cursor
Status Supported

Usage:

spec-kitty init my-project --ai cursor

Qwen Code

Property Value
Directory .qwen/
Commands subdirectory commands/
CLI flag --ai qwen
Status Supported

Usage:

spec-kitty init my-project --ai qwen

OpenCode

Property Value
Directory .opencode/
Commands subdirectory command/ (note: singular)
CLI flag --ai opencode
Status Supported

Note: OpenCode uses command/ (singular) instead of commands/ (plural).

Usage:

spec-kitty init my-project --ai opencode

Windsurf

Property Value
Directory .windsurf/
Commands subdirectory workflows/
CLI flag --ai windsurf
Status Supported

Note: Windsurf uses workflows/ instead of commands/.

Usage:

spec-kitty init my-project --ai windsurf

GitHub Codex

Property Value
Directory .codex/
Commands subdirectory prompts/
CLI flag --ai codex
Status Supported

Environment Variable: Set CODEX_HOME to point to your project:

export CODEX_HOME="$(pwd)/.codex"

Usage:

spec-kitty init my-project --ai codex

Kilocode

Property Value
Directory .kilocode/
Commands subdirectory workflows/
CLI flag --ai kilocode
Status Supported

Note: Kilocode uses workflows/ instead of commands/.

Usage:

spec-kitty init my-project --ai kilocode

Auggie CLI

Property Value
Directory .augment/
Commands subdirectory commands/
CLI flag --ai auggie
Status Supported

Usage:

spec-kitty init my-project --ai auggie

Roo Cline

Property Value
Directory .roo/
Commands subdirectory commands/
CLI flag --ai roo
Status Supported

Usage:

spec-kitty init my-project --ai roo

Amazon Q

Property Value
Directory .amazonq/
Commands subdirectory prompts/
CLI flag --ai q
Status Supported (limited)

Limitation: Amazon Q does not support custom slash command arguments. Commands like /spec-kitty.specify <description> may not pass the description to the command.

Usage:

spec-kitty init my-project --ai q

Multi-Agent Setup

You can initialize a project with multiple agents:

# Initialize with Claude and Codex
spec-kitty init my-project --ai claude,codex

# Initialize with all agents
spec-kitty init my-project --ai claude,copilot,gemini,cursor,qwen,opencode,windsurf,codex,kilocode,augment,roo,q

This creates command directories for all specified agents, allowing team members to use their preferred tool.

Adding Agents Later

To add agent support to an existing project:

# Upgrade regenerates all agent directories
spec-kitty upgrade

Or manually create the directory structure:

mkdir -p .cursor/commands
# Copy command files from another agent
cp .claude/commands/*.md .cursor/commands/

Slash Commands

All agents support the same 14 slash commands:

Command Purpose
/spec-kitty.specify Create feature specification
/spec-kitty.plan Create implementation plan
/spec-kitty.tasks Generate work packages
/spec-kitty.implement Start WP implementation
/spec-kitty.review Review completed work
/spec-kitty.accept Accept feature for merge
/spec-kitty.merge Merge feature to main
/spec-kitty.status Show kanban status
/spec-kitty.dashboard Open web dashboard
/spec-kitty.constitution Create project principles
/spec-kitty.clarify Clarify requirements
/spec-kitty.research Conduct research
/spec-kitty.checklist Generate checklists
/spec-kitty.analyze Analyze codebase

See Slash Commands for complete documentation.

Agent Selection Guidelines

Scenario Recommended Agent
Best overall experience Claude Code
VS Code integration Cursor, GitHub Copilot
JetBrains IDEs Cursor
AWS environment Amazon Q
Open source preference OpenCode, Qwen
Enterprise/air-gapped Any (local templates available)

Troubleshooting

Slash commands not appearing

  1. Verify the agent directory exists:

    ls -la .claude/commands/

  2. Regenerate commands:

    spec-kitty upgrade

  3. Restart your AI agent

Agent-specific issues

Amazon Q: Commands may not receive arguments. Enter the description when prompted instead of passing it to the command.

Codex: Ensure CODEX_HOME is set:

export CODEX_HOME="$(pwd)/.codex"

See Also

Getting Started

Practical Usage

Background

Edit this page