spec-kitty

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.*
Augment Code	.augment/	commands/	/spec-kitty.*
Roo Cline	.roo/	commands/	/spec-kitty.*
Amazon Q	.amazonq/	prompts/	/spec-kitty.*

---

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

---

Augment Code

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

Usage:

spec-kitty init my-project --ai augment

---

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

• Slash Commands — Complete command reference
• CLI Commands — spec-kitty command reference
• Install & Upgrade — Installation guide

Getting Started

• Claude Code Integration

Practical Usage

• Install Spec Kitty
• Use the Dashboard

Background

• AI Agent Architecture

This site is open source. Improve this page.