π« Toolkit to help you get started with SDD or any other process!
feat(integrations): add Muse Code (muse) agent integration (#4413)
Gabriele Berti4dd8afa37ba7
diff --git a/.github/ISSUE_TEMPLATE/agent_request.yml b/.github/ISSUE_TEMPLATE/agent_request.ymlindex 344b1c903..4e98030af 100644--- a/.github/ISSUE_TEMPLATE/agent_request.yml+++ b/.github/ISSUE_TEMPLATE/agent_request.yml@@ -8,7 +8,7 @@ body:value: |Thanks for requesting a new agent! Before submitting, please check if the agent is already supported.- **Currently supported agents**: Alquimia AI, Amp, Antigravity, Auggie CLI, Claude Code, Cline, CodeBuddy, Codex CLI, Command Code, Cursor, Devin for Terminal, Docker Agent, Factory Droid, DeepSeek Harness, Firebender, Forge, Gemini CLI, GitHub Copilot, Goose, Grok Build, Hermes Agent, IBM Bob, Junie, Kilo Code, Kimi Code, Kiro CLI, Lingma, Mistral Vibe, Oh My Pi, opencode, Pi Coding Agent, Qoder CLI, Qwen Code, RovoDev ACLI, SHAI, Tabnine CLI, Trae, ZCode, Zed+ **Currently supported agents**: Alquimia AI, Amp, Antigravity, Auggie CLI, Claude Code, Cline, CodeBuddy, Codex CLI, Command Code, Cursor, Devin for Terminal, Docker Agent, Factory Droid, DeepSeek Harness, Firebender, Forge, Gemini CLI, GitHub Copilot, Goose, Grok Build, Hermes Agent, IBM Bob, Junie, Kilo Code, Kimi Code, Kiro CLI, Lingma, Mistral Vibe, Muse Code, Oh My Pi, opencode, Pi Coding Agent, Qoder CLI, Qwen Code, RovoDev ACLI, SHAI, Tabnine CLI, Trae, ZCode, Zed- type: inputid: agent-namediff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.ymlindex a89e441d3..ca386d644 100644--- a/.github/ISSUE_TEMPLATE/bug_report.yml+++ b/.github/ISSUE_TEMPLATE/bug_report.yml@@ -90,6 +90,7 @@ body:- Kiro CLI- Lingma- Mistral Vibe+ - Muse Code- Oh My Pi- opencode- Pi Coding Agentdiff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.ymlindex f80040e33..149ce45c1 100644--- a/.github/ISSUE_TEMPLATE/feature_request.yml+++ b/.github/ISSUE_TEMPLATE/feature_request.yml@@ -84,6 +84,7 @@ body:- Kiro CLI- Lingma- Mistral Vibe+ - Muse Code- Oh My Pi- opencode- Pi Coding Agentdiff --git a/docs/reference/integrations.md b/docs/reference/integrations.mdindex ac9e2978b..551f73c97 100644--- a/docs/reference/integrations.md+++ b/docs/reference/integrations.md@@ -34,6 +34,7 @@ The Specify CLI supports a wide range of AI coding agents. When you run `specify| [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` | |+| [Muse Code](https://dev.meta.ai/docs/muse-code) | `muse` | Skills-based integration; installs skills into `.agents/skills` and invokes them as `/speckit-<command>` || [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) |diff --git a/extensions/agent-context/agent-context-defaults.json b/extensions/agent-context/agent-context-defaults.jsonindex b50c10d69..8c5f781ab 100644--- a/extensions/agent-context/agent-context-defaults.json+++ b/extensions/agent-context/agent-context-defaults.json@@ -25,6 +25,7 @@"kimi": "AGENTS.md","kiro-cli": "AGENTS.md","lingma": ".lingma/rules/specify-rules.md",+ "muse": "AGENTS.md","omp": "AGENTS.md","opencode": "AGENTS.md","pi": "AGENTS.md",diff --git a/integrations/catalog.json b/integrations/catalog.jsonindex d4dbb168d..55b4ec1fa 100644--- a/integrations/catalog.json+++ b/integrations/catalog.json@@ -362,6 +362,15 @@"author": "spec-kit-core","repository": "https://github.com/github/spec-kit","tags": ["ide", "skills"]+ },+ "muse": {+ "id": "muse",+ "name": "Muse Code",+ "version": "1.0.0",+ "description": "Meta Muse Code CLI skills-based integration",+ "author": "spec-kit-core",+ "repository": "https://github.com/github/spec-kit",+ "tags": ["cli", "skills"]}}}diff --git a/src/specify_cli/_invocation_style.py b/src/specify_cli/_invocation_style.pyindex 3233a6bab..9fa115212 100644--- a/src/specify_cli/_invocation_style.py+++ b/src/specify_cli/_invocation_style.py@@ -13,7 +13,7 @@ DOLLAR_SKILLS_AGENTS: frozenset[str] = frozenset({"codex", "zcode", "command-cod# Agents that always render /speckit-<name>, regardless of ai_skills.ALWAYS_SLASH_AGENTS: frozenset[str] = frozenset(- {"devin", "droid", "dsh", "grok", "qodercli", "trae", "zed"}+ {"devin", "droid", "dsh", "grok", "muse", "qodercli", "trae", "zed"})# Agents that render /speckit-<name> only when ai_skills is enabled.diff --git a/src/specify_cli/commands/init.py b/src/specify_cli/commands/init.pyindex 2f686e2fa..dfce1b3d1 100644--- a/src/specify_cli/commands/init.py+++ b/src/specify_cli/commands/init.py@@ -1012,6 +1012,7 @@ def register(app: typer.Typer) -> None:copilot_skill_mode = selected_ai == "copilot" and _is_skills_integrationdevin_skill_mode = selected_ai == "devin"zed_skill_mode = selected_ai == "zed" and _is_skills_integration+ muse_skill_mode = selected_ai == "muse" and _is_skills_integrationgrok_skill_mode = selected_ai == "grok" and _is_skills_integrationdsh_skill_mode = selected_ai == "dsh" and _is_skills_integrationcline_skill_mode = selected_ai == "cline"@@ -1028,6 +1029,7 @@ def register(app: typer.Typer) -> None:or copilot_skill_modeor devin_skill_modeor zed_skill_mode+ or muse_skill_modeor grok_skill_modeor dsh_skill_modeor bob_skill_mode@@ -1063,6 +1065,11 @@ def register(app: typer.Typer) -> None:f"{step_num}. Start Zed in this project directory; spec-kit skills were installed to [cyan].agents/skills[/cyan]")step_num += 1+ if muse_skill_mode:+ steps_lines.append(+ f"{step_num}. Start Muse Code in this project directory; spec-kit skills were installed to [cyan].agents/skills[/cyan]"+ )+ step_num += 1if grok_skill_mode:steps_lines.append(f"{step_num}. Start Grok Build in this project directory; spec-kit skills were installed to [cyan].grok/skills[/cyan]"diff --git a/src/specify_cli/integrations/__init__.py b/src/specify_cli/integrations/__init__.pyindex d3e58c963..ad3836693 100644--- a/src/specify_cli/integrations/__init__.py+++ b/src/specify_cli/integrations/__init__.py@@ -75,6 +75,7 @@ def _register_builtins() -> None:from .kimi import KimiIntegrationfrom .kiro_cli import KiroCliIntegrationfrom .lingma import LingmaIntegration+ from .muse import MuseIntegrationfrom .omp import OmpIntegrationfrom .opencode import OpencodeIntegrationfrom .pi import PiIntegration@@ -117,6 +118,7 @@ def _register_builtins() -> None:_register(KimiIntegration())_register(KiroCliIntegration())_register(LingmaIntegration())+ _register(MuseIntegration())_register(OmpIntegration())_register(OpencodeIntegration())_register(PiIntegration())diff --git a/src/specify_cli/integrations/muse/__init__.py b/src/specify_cli/integrations/muse/__init__.pynew file mode 100644index 000000000..e812ae386--- /dev/null+++ b/src/specify_cli/integrations/muse/__init__.py@@ -0,0 +1,63 @@+"""Muse Code integration β skills-based agent (Meta).++Muse Code discovers project skills from+``.agents/skills/speckit-<name>/SKILL.md`` and invokes them via their+slash shortcut (``/speckit-<command>``).++See: https://dev.meta.ai/docs/muse-code+"""++from __future__ import annotations++from ..base import IntegrationOption, SkillsIntegration+++class MuseIntegration(SkillsIntegration):+ """Integration for Muse Code CLI."""++ key = "muse"+ config = {+ "name": "Muse Code",+ "folder": ".agents/",+ "commands_subdir": "skills",+ "install_url": "https://dev.meta.ai/docs/muse-code",+ "requires_cli": True,+ }+ registrar_config = {+ "dir": ".agents/skills",+ "format": "markdown",+ "args": "$ARGUMENTS",+ "extension": "/SKILL.md",+ }+ # Muse Code shares the ``.agents/skills`` layout with Codex and Zed.+ # Keep co-installation opt-in until shared manifest ownership is supported.+ multi_install_safe = False++ @classmethod+ def options(cls) -> list[IntegrationOption]:+ return [+ IntegrationOption(+ "--skills",+ is_flag=True,+ default=True,+ help="Install as agent skills (default for Muse Code)",+ ),+ ]++ def build_exec_args(+ self,+ prompt: str,+ *,+ model: str | None = None,+ output_json: bool = True,+ ) -> list[str] | None:+ # Muse Code uses ``muse exec "<prompt>"`` for non-interactive mode.+ # Resolve argv[0] via the shared executable resolver so operators can+ # override the binary with SPECKIT_INTEGRATION_MUSE_EXECUTABLE.+ args: list[str] = [self._resolve_executable(), "exec", prompt]+ self._apply_extra_args_env_var(args)+ if model:+ args.extend(["--model", model])+ if output_json:+ args.append("--json")+ return argsdiff --git a/tests/integrations/test_integration_muse.py b/tests/integrations/test_integration_muse.pynew file mode 100644index 000000000..eb6f3d908--- /dev/null+++ b/tests/integrations/test_integration_muse.py@@ -0,0 +1,80 @@+"""Tests for MuseIntegration β skills-based integration (Meta Muse Code)."""++from .test_integration_base_skills import SkillsIntegrationTests+++class TestMuseIntegration(SkillsIntegrationTests):+ KEY = "muse"+ FOLDER = ".agents/"+ COMMANDS_SUBDIR = "skills"+ REGISTRAR_DIR = ".agents/skills"+++class TestMuseMetadata:+ """Muse Code-specific metadata and headless dispatch."""++ def test_display_name(self):+ from specify_cli.integrations import get_integration++ assert get_integration("muse").config["name"] == "Muse Code"++ def test_requires_cli(self):+ from specify_cli.integrations import get_integration++ assert get_integration("muse").config["requires_cli"] is True++ def test_install_url_points_to_muse_docs(self):+ from specify_cli.integrations import get_integration++ assert (+ get_integration("muse").config["install_url"]+ == "https://dev.meta.ai/docs/muse-code"+ )++ def test_not_multi_install_safe(self):+ """Muse Code shares ``.agents/skills`` with Codex/Zed, so co-install+ stays opt-in (same policy as the docker-agent integration)."""+ from specify_cli.integrations import get_integration++ assert get_integration("muse").multi_install_safe is False++ def test_build_exec_args_uses_muse_exec(self):+ from specify_cli.integrations import get_integration++ args = get_integration("muse").build_exec_args("do the thing")+ assert args[:3] == ["muse", "exec", "do the thing"]+ assert args[-1] == "--json"++ def test_build_exec_args_model_flag(self):+ from specify_cli.integrations import get_integration++ args = get_integration("muse").build_exec_args(+ "do the thing", model="muse-spark-1.2", output_json=False+ )+ assert "--model" in args+ assert args[args.index("--model") + 1] == "muse-spark-1.2"+ assert "--json" not in args++ def test_next_steps_show_slash_skill_invocation(self, tmp_path):+ """Muse Code next-steps guidance should display /speckit-* usage."""+ import os+ from typer.testing import CliRunner+ from specify_cli import app++ project = tmp_path / "muse-next-steps"+ project.mkdir()+ old_cwd = os.getcwd()+ try:+ os.chdir(project)+ runner = CliRunner()+ result = runner.invoke(app, [+ "init", "--here", "--integration", "muse",+ "--ignore-agent-tools", "--script", "sh",+ ], catch_exceptions=False)+ finally:+ os.chdir(old_cwd)++ assert result.exit_code == 0+ assert "/speckit-constitution" in result.output+ assert "/speckit.constitution" not in result.output+ assert "Muse Code" in result.outputdiff --git a/tests/integrations/test_registry.py b/tests/integrations/test_registry.pyindex 87b30a48d..590b9edf9 100644--- a/tests/integrations/test_registry.py+++ b/tests/integrations/test_registry.py@@ -28,7 +28,7 @@ ALL_INTEGRATION_KEYS = ["gemini", "tabnine",# Stage 5 β skills, generic & option-driven integrations"codex", "kimi", "agy", "zed", "generic",- "droid", "command-code", "dsh",+ "droid", "command-code", "dsh", "muse",]diff --git a/tests/test_agent_config_consistency.py b/tests/test_agent_config_consistency.pyindex 16dbcae81..6ca4de9c6 100644--- a/tests/test_agent_config_consistency.py+++ b/tests/test_agent_config_consistency.py@@ -41,6 +41,7 @@ ISSUE_TEMPLATE_AGENT_KEYS = ["kiro-cli","lingma","vibe",+ "muse","omp","opencode","pi",