π« Toolkit to help you get started with SDD or any other process!
feat: add Firebender integration (Android Studio / IntelliJ) (#3077)
Ali jawwad0a126256e0a3
diff --git a/docs/reference/integrations.md b/docs/reference/integrations.mdindex 1fe4a5364..a04e9db1d 100644--- a/docs/reference/integrations.md+++ b/docs/reference/integrations.md@@ -15,6 +15,7 @@ The Specify CLI supports a wide range of AI coding agents. When you run `specify| [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` | |@@ -185,6 +186,7 @@ The currently declared multi-install safe integrations are:| `codebuddy` | `.codebuddy/commands`, `CODEBUDDY.md` || `codex` | `.agents/skills`, `AGENTS.md` || `cursor-agent` | `.cursor/skills`, `.cursor/rules/specify-rules.mdc` |+| `firebender` | `.firebender/commands`, `.firebender/rules/specify-rules.mdc` || `gemini` | `.gemini/commands`, `GEMINI.md` || `iflow` | `.iflow/commands`, `IFLOW.md` || `junie` | `.junie/commands`, `.junie/AGENTS.md` |diff --git a/integrations/catalog.json b/integrations/catalog.jsonindex f89af37d5..5e6862ec1 100644--- a/integrations/catalog.json+++ b/integrations/catalog.json@@ -1,6 +1,6 @@{"schema_version": "1.0",- "updated_at": "2026-06-02T00:00:00Z",+ "updated_at": "2026-06-22T00:00:00Z","catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/integrations/catalog.json","integrations": {"claude": {@@ -102,6 +102,15 @@"repository": "https://github.com/github/spec-kit","tags": ["cli"]},+ "firebender": {+ "id": "firebender",+ "name": "Firebender",+ "version": "1.0.0",+ "description": "Firebender IDE integration for Android Studio / IntelliJ",+ "author": "spec-kit-core",+ "repository": "https://github.com/github/spec-kit",+ "tags": ["ide"]+ },"forge": {"id": "forge","name": "Forge",diff --git a/src/specify_cli/integrations/__init__.py b/src/specify_cli/integrations/__init__.pyindex a81d70554..fe09468a7 100644--- a/src/specify_cli/integrations/__init__.py+++ b/src/specify_cli/integrations/__init__.py@@ -58,6 +58,7 @@ def _register_builtins() -> None:from .copilot import CopilotIntegrationfrom .cursor_agent import CursorAgentIntegrationfrom .devin import DevinIntegration+ from .firebender import FirebenderIntegrationfrom .forge import ForgeIntegrationfrom .gemini import GeminiIntegrationfrom .generic import GenericIntegration@@ -95,6 +96,7 @@ def _register_builtins() -> None:_register(CopilotIntegration())_register(CursorAgentIntegration())_register(DevinIntegration())+ _register(FirebenderIntegration())_register(ForgeIntegration())_register(GeminiIntegration())_register(GenericIntegration())diff --git a/src/specify_cli/integrations/firebender/__init__.py b/src/specify_cli/integrations/firebender/__init__.pynew file mode 100644index 000000000..b49140b1f--- /dev/null+++ b/src/specify_cli/integrations/firebender/__init__.py@@ -0,0 +1,33 @@+"""Firebender IDE integration.++Firebender (https://firebender.com/) is an AI coding agent for Android Studio+and IntelliJ. It reads project-local custom slash commands from+``.firebender/commands/*.mdc`` and project rules from ``.firebender/rules/*.mdc``,+so Spec Kit installs its command templates as ``.mdc`` command files and writes+the managed context section into a ``.firebender/rules/`` rule file.+"""++from ..base import MarkdownIntegration+++class FirebenderIntegration(MarkdownIntegration):+ key = "firebender"+ config = {+ "name": "Firebender",+ "folder": ".firebender/",+ "commands_subdir": "commands",+ "install_url": "https://firebender.com/",+ "requires_cli": False,+ }+ registrar_config = {+ "dir": ".firebender/commands",+ "format": "markdown",+ "args": "$ARGUMENTS",+ "extension": ".mdc",+ }+ context_file = ".firebender/rules/specify-rules.mdc"+ multi_install_safe = True++ def command_filename(self, template_name: str) -> str:+ """Firebender reads custom slash commands from ``.firebender/commands/*.mdc``."""+ return f"speckit.{template_name}.mdc"diff --git a/tests/integrations/test_integration_firebender.py b/tests/integrations/test_integration_firebender.pynew file mode 100644index 000000000..b42d2fbf9--- /dev/null+++ b/tests/integrations/test_integration_firebender.py@@ -0,0 +1,45 @@+"""Tests for FirebenderIntegration."""++from specify_cli.integrations import get_integration+from specify_cli.integrations.manifest import IntegrationManifest++from .test_integration_base_markdown import MarkdownIntegrationTests+++class TestFirebenderIntegration(MarkdownIntegrationTests):+ KEY = "firebender"+ FOLDER = ".firebender/"+ COMMANDS_SUBDIR = "commands"+ REGISTRAR_DIR = ".firebender/commands"+ CONTEXT_FILE = ".firebender/rules/specify-rules.mdc"++ # Firebender reads custom slash commands from ``.firebender/commands/*.mdc``,+ # so this integration uses the ``.mdc`` extension instead of the ``.md``+ # default the base mixin assumes. Override the two extension-specific tests.+ def test_registrar_config(self):+ i = get_integration(self.KEY)+ assert i.registrar_config["dir"] == self.REGISTRAR_DIR+ assert i.registrar_config["format"] == "markdown"+ assert i.registrar_config["args"] == "$ARGUMENTS"+ assert i.registrar_config["extension"] == ".mdc"++ def test_setup_creates_files(self, tmp_path):+ i = get_integration(self.KEY)+ m = IntegrationManifest(self.KEY, tmp_path)+ created = i.setup(tmp_path, m)+ assert len(created) > 0+ cmd_files = [f for f in created if "scripts" not in f.parts]+ for f in cmd_files:+ assert f.exists()+ assert f.name.startswith("speckit.")+ assert f.name.endswith(".mdc")++ def _expected_files(self, script_variant: str) -> list[str]:+ # Firebender emits ``.mdc`` command files, so remap the base mixin's+ # ``.md`` expectations for files under this integration's command dir.+ cmd_dir = get_integration(self.KEY).registrar_config["dir"]+ prefix = cmd_dir + "/"+ return sorted(+ f[:-3] + ".mdc" if f.startswith(prefix) and f.endswith(".md") else f+ for f in super()._expected_files(script_variant)+ )diff --git a/tests/integrations/test_registry.py b/tests/integrations/test_registry.pyindex 7582bd671..0110e19ec 100644--- a/tests/integrations/test_registry.py+++ b/tests/integrations/test_registry.py@@ -23,7 +23,7 @@ ALL_INTEGRATION_KEYS = [# Stage 3 β standard markdown integrations"claude", "qwen", "opencode", "junie", "kilocode", "auggie","roo", "rovodev", "codebuddy", "qodercli", "amp", "shai", "bob", "trae",- "pi", "iflow", "kiro-cli", "windsurf", "vibe", "cursor-agent",+ "pi", "iflow", "kiro-cli", "windsurf", "vibe", "cursor-agent", "firebender",# Stage 4 β TOML integrations"gemini", "tabnine",# Stage 5 β skills, generic & option-driven integrations