Skip to content

generate integrations reference from catalog #2563

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DyanGalih wants to merge 38 commits into
base: main
Choose a base branch
from
Open

generate integrations reference from catalog #2563

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
fc6daad
docs: generate integrations reference from catalog
DyanGalih May 14, 2026
68831fd
refactor: integrate table rendering into specify integration search -…
DyanGalih May 14, 2026
97df84c
fix: address Copilot review feedback on catalog_docs and integration_…
DyanGalih May 14, 2026
d7acf29
fix: add sync test, INTEGRATIONS_REFERENCE_PATH constant, and fix naming
DyanGalih May 15, 2026
3fa13e7
revert: restore docs/reference/integrations.md to upstream/main; remo…
DyanGalih May 15, 2026
94e9186
fix: remove dead INTEGRATIONS_REFERENCE_PATH, drop URL-length padding…
DyanGalih May 15, 2026
f643102
fix: send --markdown warnings/errors to stderr, rename test for clarity
DyanGalih May 15, 2026
3ca670a
fix: detect stale doc-map keys, test _render_cell escaping, strengthe…
DyanGalih May 15, 2026
982102f
refactor: promote _render_cell to public render_cell function
DyanGalih May 15, 2026
76cd163
test: mock registry and doc maps to avoid brittle live registry coupling
DyanGalih May 15, 2026
41c5c1c
refactor: flatten patches, remove unused imports, fix trailing whites…
DyanGalih May 15, 2026
f539e81
refactor: make validation non-fatal, fix context manager syntax, add …
DyanGalih May 15, 2026
3278fe6
fix: improve docstring clarity, test robustness, and exception handling
DyanGalih May 15, 2026
641a531
fix: improve test assertions, disable warnings by default, enhance ex…
DyanGalih May 15, 2026
6fa65ea
fix: make CLI tests deterministic and improve config access resilience
DyanGalih May 15, 2026
8004ad4
fix: remove extra blank line, add stale keys validation, add regressi…
DyanGalih May 16, 2026
c43996d
Fix 5 remaining feedback items:
DyanGalih May 16, 2026
f445342
address all outstanding copilot review feedback on PR 2563
DyanGalih May 18, 2026
d6380a3
Address Copilot feedback: escape URLs in markdown links, deduplicate …
DyanGalih May 18, 2026
82c625b
Address 3 new Copilot feedback: add URL escaping test, fix parse_firs…
DyanGalih May 18, 2026
68b54f2
Address 3 new Copilot feedback: escape id field, remove unused alias,…
DyanGalih May 18, 2026
53530ea
Address 3 new Copilot feedback: fix comment name, include all integra…
DyanGalih May 18, 2026
dbcf78a
Fix architectural issue: escape raw fields before composing Markdown …
DyanGalih May 18, 2026
137c5a8
Deduplicate _escape_url_for_markdown_link and add URL escaping test
DyanGalih May 18, 2026
d2b45a7
Address 4 new Copilot feedback: add trailing newline, fix test helper…
DyanGalih May 18, 2026
da2f42a
Address 4 new Copilot feedback: make escape function public, fix erro…
DyanGalih May 18, 2026
8b3e9e0
Update error message in test_missing_catalog_file for clarity
DyanGalih May 19, 2026
1e9e3fa
Remove obsolete integrations sync test
DyanGalih May 20, 2026
bf98504
keep integrations docs in sync
DyanGalih May 21, 2026
a180eeb
Potential fix for pull request finding
DyanGalih May 22, 2026
c4c7fab
Potential fix for pull request finding
DyanGalih May 22, 2026
4f06e06
Potential fix for pull request finding
DyanGalih May 22, 2026
bedb02b
Potential fix for pull request finding
DyanGalih May 22, 2026
f223704
fix: address remaining integrations docs feedback
DyanGalih May 24, 2026
7f0ce30
fix: address remaining PR 2563 feedback
DyanGalih May 25, 2026
54c0e41
test: tighten community docs regression
DyanGalih May 28, 2026
224f865
fix: add trailing commas to catalog docs warnings
DyanGalih Jul 7, 2026
47dcfb3
Fix integration docs and lint cleanup
DyanGalih Jul 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 36 additions & 36 deletions docs/reference/integrations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,42 +4,42 @@ The Specify CLI supports a wide range of AI coding agents. When you run `specify

## Supported AI Coding Agents

| Agent | Key | Notes |
| ------------------------------------------------------------------------------------ | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| [Amp](https://ampcode.com/) | `amp` | |
| [Antigravity (agy)](https://antigravity.google/) | `agy` | Skills-based integration; skills are installed automatically |
| [Auggie CLI](https://docs.augmentcode.com/cli/overview) | `auggie` | |
| [Claude Code](https://www.anthropic.com/claude-code) | `claude` | Skills-based integration; installs skills in `.claude/skills` |
| [Cline](https://github.com/cline/cline) | `cline` | IDE-based agent |
| [CodeBuddy CLI](https://www.codebuddy.cn/docs/cli/installation) | `codebuddy` | |
| [Codex CLI](https://github.com/openai/codex) | `codex` | Skills-based integration; installs skills into `.agents/skills` and invokes them as `$speckit-<command>` |
| [Cursor](https://cursor.sh/) | `cursor-agent` | |
| [Devin for Terminal](https://cli.devin.ai/docs) | `devin` | Skills-based integration; installs skills into `.devin/skills/` and invokes them as `/speckit-<command>` |
| [Firebender](https://firebender.com/) | `firebender` | IDE-based agent for Android Studio / IntelliJ |
| [Forge](https://forgecode.dev/) | `forge` | |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | |
| [GitHub Copilot](https://code.visualstudio.com/) | `copilot` | |
| [Goose](https://goose-docs.ai/) | `goose` | Uses YAML recipe format in `.goose/recipes/` |
| [Hermes](https://github.com/NousResearch/hermes-agent) | `hermes` | Skills-based integration; installs skills globally into `~/.hermes/skills/` |
| [IBM Bob](https://www.ibm.com/products/bob) | `bob` | IDE-based agent |
| [Junie](https://junie.jetbrains.com/) | `junie` | |
| [Kilo Code](https://github.com/Kilo-Org/kilocode) | `kilocode` | |
| [Kimi Code](https://code.kimi.com/) | `kimi` | Skills-based integration; installs into `.kimi-code/skills/`. `--migrate-legacy` moves old `.kimi/skills/` installs to the new paths |
| [Kiro CLI](https://kiro.dev/docs/cli/) | `kiro-cli` | Kiro CLI does not substitute `$ARGUMENTS` in file-based prompts, so Spec Kit ships a prose fallback at render time (see [Manage prompts](https://kiro.dev/docs/cli/chat/manage-prompts/) and issue [#1926](https://github.com/github/spec-kit/issues/1926)). Alias: `--integration kiro` |
| [Lingma](https://lingma.aliyun.com/) | `lingma` | Skills-based integration; skills are installed automatically |
| [Mistral Vibe](https://github.com/mistralai/mistral-vibe) | `vibe` | |
| [Oh My Pi](https://www.npmjs.com/package/@oh-my-pi/pi-coding-agent) | `omp` | Installs slash commands into `.omp/commands` |
| [opencode](https://opencode.ai/) | `opencode` | |
| [Pi Coding Agent](https://pi.dev) | `pi` | Pi doesn't have MCP support out of the box, so `taskstoissues` won't work as intended. MCP support can be added via [extensions](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent#extensions) |
| [Qoder CLI](https://qoder.com/cli) | `qodercli` | |
| [Qwen Code](https://github.com/QwenLM/qwen-code) | `qwen` | |
| [RovoDev](https://www.atlassian.com/software/rovo-dev) | `rovodev` | Generates `.rovodev/skills/`, prompt wrappers, and `prompts.yml`; runtime dispatch uses `acli rovodev` |
| [SHAI (OVHcloud)](https://github.com/ovh/shai) | `shai` | |
| [Tabnine CLI](https://docs.tabnine.com/main/getting-started/tabnine-cli) | `tabnine` | |
| [Trae](https://www.trae.ai/) | `trae` | Skills-based integration; skills are installed automatically |
| [ZCode](https://zcode.z.ai/) | `zcode` | Skills-based integration; installs skills into `.zcode/skills/` and invokes them as `$speckit-<command>` |
| [Zed](https://zed.dev/) | `zed` | Skills-based integration; installs skills into `.agents/skills` and invokes them as `/speckit-<command>` |
| Generic | `generic` | Bring your own agent — use `--integration generic --integration-options="--commands-dir <path>"` for AI coding agents not listed above |
| Agent | Key | Notes |
| --- | --- | --- |
| [Antigravity (agy)](https://antigravity.google/) | `agy` | Skills-based integration; skills are installed automatically |
| [Amp](https://ampcode.com/) | `amp` | |
| [Auggie CLI](https://docs.augmentcode.com/cli/overview) | `auggie` | |
| [IBM Bob](https://www.ibm.com/products/bob) | `bob` | IDE-based agent |
| [Claude Code](https://www.anthropic.com/claude-code) | `claude` | Skills-based integration; installs skills in `.claude/skills` |
| Cline | `cline` | |
| [CodeBuddy CLI](https://www.codebuddy.ai/cli) | `codebuddy` | |
| [Codex CLI](https://github.com/openai/codex) | `codex` | Skills-based integration; installs skills into `.agents/skills` and invokes them as `$speckit-<command>` |
| [GitHub Copilot](https://code.visualstudio.com/) | `copilot` | |
| [Cursor](https://cursor.sh/) | `cursor-agent` | |
| [Devin for Terminal](https://cli.devin.ai/docs) | `devin` | Skills-based integration; installs skills into `.devin/skills/` and invokes them as `/speckit-<command>` |
| Firebender | `firebender` | |
| [Forge](https://forgecode.dev/) | `forge` | |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | |
| Generic | `generic` | Bring your own agent — use `--integration generic --integration-options="--commands-dir <path>"` for AI coding agents not listed above |
| [Goose](https://block.github.io/goose/) | `goose` | Uses YAML recipe format in `.goose/recipes/` |
| Hermes Agent | `hermes` | |
| [Junie](https://junie.jetbrains.com/) | `junie` | |
| [Kilo Code](https://github.com/Kilo-Org/kilocode) | `kilocode` | |
| [Kimi Code](https://code.kimi.com/) | `kimi` | Skills-based integration; supports `--migrate-legacy` for dotted→hyphenated directory migration |
| [Kiro CLI](https://kiro.dev/docs/cli/) | `kiro-cli` | Kiro CLI does not substitute `$ARGUMENTS` in file-based prompts, so Spec Kit ships a prose fallback at render time (see [Manage prompts](https://kiro.dev/docs/cli/chat/manage-prompts/) and issue [#1926](https://github.com/github/spec-kit/issues/1926)). Alias: `--integration kiro` |
| [Lingma](https://lingma.aliyun.com/) | `lingma` | Skills-based integration; skills are installed automatically |
| Oh My Pi | `omp` | |
| [opencode](https://opencode.ai/) | `opencode` | |
| [Pi Coding Agent](https://pi.dev) | `pi` | Pi doesn't have MCP support out of the box, so `taskstoissues` won't work as intended. MCP support can be added via [extensions](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent#extensions) |
| [Qoder CLI](https://qoder.com/cli) | `qodercli` | |
| [Qwen Code](https://github.com/QwenLM/qwen-code) | `qwen` | |
| RovoDev ACLI | `rovodev` | |
| [SHAI (OVHcloud)](https://github.com/ovh/shai) | `shai` | |
| [Tabnine CLI](https://docs.tabnine.com/main/getting-started/tabnine-cli) | `tabnine` | |
| [Trae](https://www.trae.ai/) | `trae` | Skills-based integration; skills are installed automatically |
| [Mistral Vibe](https://github.com/mistralai/mistral-vibe) | `vibe` | |
| ZCode | `zcode` | |
| Zed | `zed` | |

## List Available Integrations

Expand Down
Loading
Loading