spawn-cli 0.1.20__tar.gz → 0.1.22__tar.gz

{spawn_cli-0.1.20/src/spawn_cli.egg-info → spawn_cli-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawn-cli
-Version: 0.1.20
+Version: 0.1.22
 Summary: A minimal installable Python CLI package.
 License: MIT
 Classifier: License :: OSI Approved :: MIT License
@@ -240,14 +240,40 @@ read-required:
 
 Then run **`spawn refresh`** so skills and entry points pick up the hint.
 
-## License
+### Supported IDEs
 
-MIT — see [LICENSE](LICENSE).
+| IDE (key) | Skills | MCP | Agent ignore | Entry point | Detection markers |
+| --- | --- | --- | --- | --- | --- |
+| Cursor (`cursor`) | `.cursor/skills/` | `.cursor/mcp.json` | `.cursorignore` | `AGENTS.md` | `.cursor/` |
+| Codex (`codex`) | `.agents/skills/` | `.codex/config.toml` | `config.toml` permissions | `AGENTS.md` | `.codex/`, `.agents/` |
+| Claude Code (`claude-code`) | `.claude/skills/` | `.mcp.json` | `.claude/settings.json` | `CLAUDE.md` | `.claude/`, `CLAUDE.md` |
+| Windsurf (`windsurf`) | `.windsurf/skills/` | — | `.codeiumignore` | `AGENTS.md` | `.windsurf/`, `.codeiumignore` |
+| GitHub Copilot (`github-copilot`) | `.github/skills/` | `.vscode/mcp.json` | — | `.github/copilot-instructions.md`, `AGENTS.md` | `.github/`, `.vscode/` |
+| Gemini CLI (`gemini-cli`) | `.gemini/skills/` | `.gemini/settings.json` | `.geminiignore` | `GEMINI.md` | `.gemini/`, `GEMINI.md` |
+| Cline (`cline`) | `.cline/skills/` | — | `.clineignore` | `AGENTS.md` | `.cline/`, `.clinerules`, `.clineignore` |
+| OpenCode (`opencode`) | `.opencode/skills/` | `opencode.json` | `opencode.json` permissions | `AGENTS.md` | `.opencode/`, `opencode.json`, `opencode.jsonc` |
+| Mimo Code (`mimo-code`) | `.mimocode/skills/` | `.mimocode/mimocode.json` | `mimocode.json` permissions | `AGENTS.md` | `.mimocode/` |
+| Hermes (`hermes`) | `.hermes/skills/` | — | — | `.hermes.md` | `.hermes/`, `.hermes.md`, `HERMES.md` |
+| JetBrains Junie (`junie`) | `.junie/skills/` | `.junie/mcp/mcp.json` | `.aiignore` | `AGENTS.md` | `.junie/` |
 
----
+**Legend:**
+
+- **Skills** — project directory where spawn renders `SKILL.md` per skill (`native` capability; frontmatter `name` matches the directory name).
+- **MCP** — project-scope config file where spawn merges extension MCP servers. "—" means the tool keeps MCP global-only (e.g. `~/.hermes/config.yaml`); spawn warns (`SpawnWarning`) and writes nothing.
+- **Agent ignore** — where spawn merges agent-ignore globs: a dedicated ignore file, or permissions entries in the project config (managed block / spawn-owned entries only; removal never touches user rules). "—" means no upstream ignore mechanism; spawn warns and skips.
+- **Entry point** — file(s) receiving the Spawn-managed instruction block (`<!-- spawn:start -->` ... `<!-- spawn:end -->`); user content around the block is preserved.
+- **Detection markers** — files/directories that make `spawn ide list-supported-ides` (and auto-detection) mark the IDE as used in the repo.
+
+Full per-IDE contracts (config shapes, ignore semantics, caveats): [spec/design/ide-adapters.md](spec/design/ide-adapters.md).
 
 P.S. Below is a diagram that might help you understand how Spawn works.
 
 <p align="center">
   <img src="logo/Scheme.png" alt="How Spawn works" />
 </p>
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/README.md

@@ -223,14 +223,40 @@ read-required:
 
 Then run **`spawn refresh`** so skills and entry points pick up the hint.
 
-## License
-
-MIT — see [LICENSE](LICENSE).
-
----
+### Supported IDEs
+
+| IDE (key) | Skills | MCP | Agent ignore | Entry point | Detection markers |
+| --- | --- | --- | --- | --- | --- |
+| Cursor (`cursor`) | `.cursor/skills/` | `.cursor/mcp.json` | `.cursorignore` | `AGENTS.md` | `.cursor/` |
+| Codex (`codex`) | `.agents/skills/` | `.codex/config.toml` | `config.toml` permissions | `AGENTS.md` | `.codex/`, `.agents/` |
+| Claude Code (`claude-code`) | `.claude/skills/` | `.mcp.json` | `.claude/settings.json` | `CLAUDE.md` | `.claude/`, `CLAUDE.md` |
+| Windsurf (`windsurf`) | `.windsurf/skills/` | — | `.codeiumignore` | `AGENTS.md` | `.windsurf/`, `.codeiumignore` |
+| GitHub Copilot (`github-copilot`) | `.github/skills/` | `.vscode/mcp.json` | — | `.github/copilot-instructions.md`, `AGENTS.md` | `.github/`, `.vscode/` |
+| Gemini CLI (`gemini-cli`) | `.gemini/skills/` | `.gemini/settings.json` | `.geminiignore` | `GEMINI.md` | `.gemini/`, `GEMINI.md` |
+| Cline (`cline`) | `.cline/skills/` | — | `.clineignore` | `AGENTS.md` | `.cline/`, `.clinerules`, `.clineignore` |
+| OpenCode (`opencode`) | `.opencode/skills/` | `opencode.json` | `opencode.json` permissions | `AGENTS.md` | `.opencode/`, `opencode.json`, `opencode.jsonc` |
+| Mimo Code (`mimo-code`) | `.mimocode/skills/` | `.mimocode/mimocode.json` | `mimocode.json` permissions | `AGENTS.md` | `.mimocode/` |
+| Hermes (`hermes`) | `.hermes/skills/` | — | — | `.hermes.md` | `.hermes/`, `.hermes.md`, `HERMES.md` |
+| JetBrains Junie (`junie`) | `.junie/skills/` | `.junie/mcp/mcp.json` | `.aiignore` | `AGENTS.md` | `.junie/` |
+
+**Legend:**
+
+- **Skills** — project directory where spawn renders `SKILL.md` per skill (`native` capability; frontmatter `name` matches the directory name).
+- **MCP** — project-scope config file where spawn merges extension MCP servers. "—" means the tool keeps MCP global-only (e.g. `~/.hermes/config.yaml`); spawn warns (`SpawnWarning`) and writes nothing.
+- **Agent ignore** — where spawn merges agent-ignore globs: a dedicated ignore file, or permissions entries in the project config (managed block / spawn-owned entries only; removal never touches user rules). "—" means no upstream ignore mechanism; spawn warns and skips.
+- **Entry point** — file(s) receiving the Spawn-managed instruction block (`<!-- spawn:start -->` ... `<!-- spawn:end -->`); user content around the block is preserved.
+- **Detection markers** — files/directories that make `spawn ide list-supported-ides` (and auto-detection) mark the IDE as used in the repo.
+
+Full per-IDE contracts (config shapes, ignore semantics, caveats): [spec/design/ide-adapters.md](spec/design/ide-adapters.md).
 
 P.S. Below is a diagram that might help you understand how Spawn works.
 
 <p align="center">
   <img src="logo/Scheme.png" alt="How Spawn works" />
 </p>
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spawn-cli"
-version = "0.1.20"
+version = "0.1.22"
 description = "A minimal installable Python CLI package."
 readme = "README.md"
 requires-python = ">=3.10"

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/src/spawn_cli/core/low_level.py

@@ -33,6 +33,10 @@ CANONICAL_IDE_KEYS: tuple[str, ...] = (
     "github-copilot",
     "gemini-cli",
     "cline",
+    "opencode",
+    "mimo-code",
+    "hermes",
+    "junie",
 )
 
 SPAWN_GITIGNORE_START = "# spawn:start"

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/src/spawn_cli/ide/__init__.py

@@ -9,8 +9,16 @@ from . import gemini_cli  # noqa: F401
 from . import github_copilot  # noqa: F401
 from . import windsurf  # noqa: F401
 from . import cline  # noqa: F401
+from . import opencode  # noqa: F401
+from . import mimo_code  # noqa: F401
+from . import hermes  # noqa: F401
+from . import junie  # noqa: F401
 from ._stub import StubAdapter
 from .cline import ClineAdapter
+from .opencode import OpenCodeAdapter
+from .mimo_code import MimoCodeAdapter
+from .hermes import HermesAdapter
+from .junie import JunieAdapter
 from .claude_code import ClaudeCodeAdapter
 from .codex import CodexAdapter
 from .cursor import CursorAdapter
@@ -45,6 +53,10 @@ from .registry import (
 __all__ = [
     "ALIASES",
     "ClineAdapter",
+    "OpenCodeAdapter",
+    "MimoCodeAdapter",
+    "HermesAdapter",
+    "JunieAdapter",
     "ClaudeCodeAdapter",
     "CodexAdapter",
     "CursorAdapter",

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/src/spawn_cli/ide/_vacancy.py

@@ -226,6 +226,66 @@ def finalize_github_copilot_repo(target_root: Path) -> None:
         pass
 
 
+_OPENCODE_CONFIG = "opencode.json"
+
+
+def _opencode_config_vacant(path: Path) -> bool:
+    data = json.loads(path.read_text(encoding="utf-8"))
+    if not isinstance(data, dict):
+        return False  # user config in an unexpected shape: keep untouched
+    if data == {}:
+        return True
+    for key, value in data.items():
+        if key in ("mcp", "permission"):
+            if value:  # non-empty -> user content or live servers
+                return False
+        elif json_value_nonempty(value):  # unknown user key with substance
+            return False
+    return True
+
+
+def finalize_opencode_repo(target_root: Path) -> None:
+    """OpenCode adapter: root `opencode.json` (keys mcp, permission) and `.opencode/skills`; drop when vacant."""
+    config = target_root / _OPENCODE_CONFIG
+    if config.is_file():
+        try:
+            vacant = _opencode_config_vacant(config)
+        except json.JSONDecodeError:
+            vacant = False  # keep unparseable user config untouched
+        if vacant:
+            config.unlink()
+    skills_dir = target_root / ".opencode" / "skills"
+    if skills_dir.is_dir() and not dir_has_any_file(skills_dir):
+        prune_empty_directories_under(target_root / ".opencode")
+    if (target_root / ".opencode").is_dir() and not dir_has_any_file(target_root / ".opencode"):
+        (target_root / ".opencode").rmdir()
+
+
+def finalize_hermes_repo(target_root: Path) -> None:
+    """Hermes adapter: `.hermes/skills` dotdir; drop when vacant."""
+    finalize_standard_dotdir_skills_and_mcp(
+        target_root,
+        ".hermes",
+        allow_delete_entire=True,
+    )
+
+
+def finalize_junie_repo(target_root: Path) -> None:
+    """Junie adapter: `.junie/{skills,mcp/mcp.json}`; drop parts when vacant, keep user content."""
+    junie_root = target_root / ".junie"
+    if not junie_root.is_dir():
+        return
+    try_unlink_empty_mcp_mcp_servers(junie_root / "mcp" / "mcp.json")
+    prune_empty_directories_under(junie_root)
+    if ide_dotdir_is_entirely_removable(junie_root, allow_delete_entire=True):
+        shutil.rmtree(junie_root, ignore_errors=True)
+    ignore = target_root / ".aiignore"
+    if ignore.is_file():
+        clear_split_agent_ignore_file(ignore)
+        if not ignore.read_text(encoding="utf-8").strip():
+            ignore.unlink(missing_ok=True)
+
+
 def finalize_cline_repo(target_root: Path) -> None:
     """Cline adapter: `.cline/skills` dotdir and root `.clineignore`; drop both when vacant."""
     finalize_standard_dotdir_skills_and_mcp(
@@ -240,10 +300,46 @@ def finalize_cline_repo(target_root: Path) -> None:
             ignore.unlink(missing_ok=True)
 
 
+def _mimo_config_vacant(path: Path) -> bool:
+    data = json.loads(path.read_text(encoding="utf-8"))
+    if not isinstance(data, dict):
+        return False  # user config in an unexpected shape: keep untouched
+    if data == {}:
+        return True
+    for key, value in data.items():
+        if key in ("mcp", "permission"):
+            if value:  # non-empty -> user content or live servers
+                return False
+        elif json_value_nonempty(value):  # unknown user key with substance
+            return False
+    return True
+
+
+def finalize_mimo_code_repo(target_root: Path) -> None:
+    """Mimo Code adapter: `.mimocode/mimocode.json` (keys mcp, permission) and `.mimocode/skills`; drop when vacant."""
+    config = target_root / ".mimocode" / "mimocode.json"
+    if config.is_file():
+        try:
+            vacant = _mimo_config_vacant(config)
+        except json.JSONDecodeError:
+            vacant = False  # keep unparseable user config untouched
+        if vacant:
+            config.unlink()
+    skills_dir = target_root / ".mimocode" / "skills"
+    if skills_dir.is_dir() and not dir_has_any_file(skills_dir):
+        prune_empty_directories_under(target_root / ".mimocode")
+    if (target_root / ".mimocode").is_dir() and not dir_has_any_file(target_root / ".mimocode"):
+        (target_root / ".mimocode").rmdir()
+
+
 __all__ = [
     "dir_has_any_file",
     "finalize_claude_repo",
     "finalize_cline_repo",
+    "finalize_hermes_repo",
+    "finalize_junie_repo",
+    "finalize_mimo_code_repo",
+    "finalize_opencode_repo",
     "finalize_codex_repo",
     "finalize_github_copilot_repo",
     "finalize_standard_dotdir_skills_and_mcp",

spawn_cli-0.1.22/src/spawn_cli/ide/hermes.py

@@ -0,0 +1,107 @@
+"""Hermes Agent (Nous Research) IDE adapter.
+
+Project scope: skills at <repo>/.hermes/skills/<name>/SKILL.md and a
+spawn-managed block in root `.hermes.md` (Hermes highest-priority project
+context file; priority: .hermes.md > AGENTS.override.md > AGENTS.md).
+MCP config and agent ignore are global-only in Hermes
+(~/.hermes/config.yaml; no ignore file) -> unsupported here.
+Project skills require `hermes skills trust` before Hermes loads them.
+`.agents/skills` is intentionally NOT used (owned by the Codex adapter).
+"""
+
+from __future__ import annotations
+
+import warnings
+from pathlib import Path
+
+from spawn_cli.errors import SpawnWarning
+from spawn_cli.ide import _vacancy as _vac
+from spawn_cli.ide._helpers import rewrite_managed_block
+from spawn_cli.ide.registry import (
+    DetectResult,
+    IdeAdapter,
+    IdeCapabilities,
+    normalize_skill_name,
+    register,
+    render_skill_md,
+)
+from spawn_cli.models.mcp import NormalizedMcp
+from spawn_cli.models.skill import SkillMetadata
+
+CAPS = IdeCapabilities(
+    skills="native",
+    mcp="unsupported",
+    agent_ignore="unsupported",
+    entry_point="hermes-md",
+)
+
+
+class HermesAdapter(IdeAdapter):
+    key = "hermes"
+
+    def detect(self, target_root: Path) -> DetectResult:
+        used = (
+            (target_root / ".hermes").is_dir()
+            or (target_root / ".hermes.md").is_file()
+            or (target_root / "HERMES.md").is_file()
+        )
+        return DetectResult(used_in_repo=used, capabilities=CAPS)
+
+    def add_skills(self, target_root: Path, skill_metadata: list[SkillMetadata]) -> list[dict]:
+        results = []
+        for skill in skill_metadata:
+            name = normalize_skill_name(skill.name)
+            skill_dir = target_root / ".hermes" / "skills" / name
+            skill_dir.mkdir(parents=True, exist_ok=True)
+            skill_path = skill_dir / "SKILL.md"
+            if skill_path.exists():
+                warnings.warn(f"Overwriting existing rendered skill: {skill_path}")
+            # Hermes requires frontmatter name == directory name.
+            rendered = render_skill_md(skill.model_copy(update={"name": name}))
+            skill_path.write_text(rendered, encoding="utf-8")
+            rel = skill_path.relative_to(target_root).as_posix()
+            results.append({"skill": skill.name, "path": rel})
+        return results
+
+    def remove_skills(self, target_root: Path, rendered_paths: list[dict]) -> None:
+        for entry in rendered_paths:
+            p = target_root / entry["path"]
+            if p.exists():
+                p.unlink()
+            if p.parent.exists() and not any(p.parent.iterdir()):
+                p.parent.rmdir()
+
+    def add_mcp(self, target_root: Path, normalized_mcp: NormalizedMcp) -> list[str]:
+        del normalized_mcp
+        del target_root
+        warnings.warn(
+            "Hermes has no project-scope MCP settings; "
+            "servers stay configured globally in ~/.hermes/config.yaml",
+            SpawnWarning,
+        )
+        return []
+
+    def remove_mcp(self, target_root: Path, rendered_mcp_names: list[str]) -> None:
+        del target_root, rendered_mcp_names
+        warnings.warn("MCP is not managed by spawn for hermes; nothing to remove", SpawnWarning)
+
+    def add_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        del target_root, globs
+        warnings.warn("hermes: agent ignore is unsupported", SpawnWarning)
+
+    def remove_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        del target_root, globs
+        warnings.warn("hermes: agent ignore is unsupported", SpawnWarning)
+
+    def rewrite_entry_point(self, target_root: Path, prompt: str) -> str:
+        ep = target_root / ".hermes.md"
+        rewrite_managed_block(ep, prompt)
+        return ep.relative_to(target_root).as_posix()
+
+    def finalize_repo_after_ide_removed(self, target_root: Path) -> None:
+        _vac.finalize_hermes_repo(target_root)
+
+
+register(HermesAdapter())
+
+__all__ = ["HermesAdapter"]

spawn_cli-0.1.22/src/spawn_cli/ide/junie.py

@@ -0,0 +1,141 @@
+"""JetBrains Junie IDE adapter: .junie/skills, .junie/mcp/mcp.json, .aiignore, AGENTS.md."""
+
+from __future__ import annotations
+
+import json
+import warnings
+from pathlib import Path
+
+from spawn_cli.errors import SpawnWarning
+from spawn_cli.ide import _vacancy as _vac
+from spawn_cli.ide.mcp_stdio_argv import mcp_stdio_argv
+from spawn_cli.ide._helpers import (
+    clear_split_agent_ignore_file,
+    remove_ignore_block,
+    rewrite_core_agent_ignore_region,
+    rewrite_extension_agent_ignore_region,
+    rewrite_ignore_block,
+)
+from spawn_cli.ide.registry import (
+    DetectResult,
+    IdeAdapter,
+    IdeCapabilities,
+    register,
+    normalize_skill_name,
+    render_skill_md,
+    rewrite_managed_block,
+)
+from spawn_cli.models.mcp import McpServer, NormalizedMcp
+from spawn_cli.models.skill import SkillMetadata
+
+
+def _build_mcp_server_entry(server: McpServer) -> dict:
+    """Convert McpServer to .junie/mcp/mcp.json entry (mcpServers format)."""
+    transport = server.transport
+    if transport.type == "stdio":
+        if server.spawn_stdio_proxy:
+            entry = {"command": "spawn", "args": mcp_stdio_argv(server.extension, server.name)}
+        else:
+            entry = {"command": transport.command, "args": transport.args}
+    elif transport.type in ("streamable-http", "sse"):
+        entry = {"type": transport.type, "url": transport.url}
+        if transport.headers:
+            entry["headers"] = {k: f"${{{v}}}" for k, v in transport.headers.items()}
+    else:
+        entry = {"command": transport.command, "args": transport.args}
+    if server.env:
+        entry["env"] = {
+            k: f"${{{k}}}" if v.secret else v.value or f"${{{k}}}"
+            for k, v in server.env.items()
+        }
+    return entry
+
+
+class JunieAdapter(IdeAdapter):
+    key = "junie"
+
+    def detect(self, target_root: Path) -> DetectResult:
+        used = (target_root / ".junie").exists()
+        return DetectResult(
+            used_in_repo=used,
+            capabilities=IdeCapabilities(
+                skills="native",
+                mcp="project",
+                agent_ignore="native",
+                entry_point="agents-md",
+            ),
+        )
+
+    def add_skills(self, target_root: Path, skill_metadata: list[SkillMetadata]) -> list[dict]:
+        results = []
+        for skill in skill_metadata:
+            name = normalize_skill_name(skill.name)
+            skill_dir = target_root / ".junie" / "skills" / name
+            skill_dir.mkdir(parents=True, exist_ok=True)
+            skill_path = skill_dir / "SKILL.md"
+            if skill_path.exists():
+                warnings.warn(f"Overwriting existing rendered skill: {skill_path}", SpawnWarning)
+            skill_path.write_text(render_skill_md(skill.model_copy(update={"name": name})), encoding="utf-8")
+            rel = skill_path.relative_to(target_root).as_posix()
+            results.append({"skill": skill.name, "path": rel})
+        return results
+
+    def remove_skills(self, target_root: Path, rendered_paths: list[dict]) -> None:
+        for entry in rendered_paths:
+            p = target_root / entry["path"]
+            if p.exists():
+                p.unlink()
+            if p.parent.exists() and not any(p.parent.iterdir()):
+                p.parent.rmdir()
+
+    def add_mcp(self, target_root: Path, normalized_mcp: NormalizedMcp) -> list[str]:
+        """Merge Spawn-owned servers into .junie/mcp/mcp.json (mcpServers format)."""
+        mcp_path = target_root / ".junie" / "mcp" / "mcp.json"
+        mcp_path.parent.mkdir(parents=True, exist_ok=True)
+        data = json.loads(mcp_path.read_text(encoding="utf-8")) if mcp_path.exists() else {}
+        data.setdefault("mcpServers", {})
+        rendered_names = []
+        for server in normalized_mcp.servers:
+            entry = _build_mcp_server_entry(server)
+            data["mcpServers"][server.name] = entry
+            rendered_names.append(server.name)
+        mcp_path.write_text(json.dumps(data, indent=2), encoding="utf-8")
+        return rendered_names
+
+    def remove_mcp(self, target_root: Path, rendered_mcp_names: list[str]) -> None:
+        """Remove named entries from .junie/mcp/mcp.json."""
+        mcp_path = target_root / ".junie" / "mcp" / "mcp.json"
+        if not mcp_path.exists():
+            return
+        data = json.loads(mcp_path.read_text(encoding="utf-8"))
+        for name in rendered_mcp_names:
+            data.get("mcpServers", {}).pop(name, None)
+        mcp_path.write_text(json.dumps(data, indent=2), encoding="utf-8")
+
+    def add_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        rewrite_ignore_block(target_root / ".aiignore", globs)
+
+    def remove_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        remove_ignore_block(target_root / ".aiignore", globs)
+
+    def rewrite_core_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        rewrite_core_agent_ignore_region(target_root / ".aiignore", globs)
+
+    def rewrite_extension_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        rewrite_extension_agent_ignore_region(target_root / ".aiignore", globs)
+
+    def clear_spawn_agent_ignore(self, target_root: Path) -> None:
+        clear_split_agent_ignore_file(target_root / ".aiignore")
+
+    def rewrite_entry_point(self, target_root: Path, prompt: str) -> str:
+        ep = target_root / "AGENTS.md"
+        rewrite_managed_block(ep, prompt)
+        return str(ep.relative_to(target_root))
+
+    def finalize_repo_after_ide_removed(self, target_root: Path) -> None:
+        _vac.finalize_junie_repo(target_root)
+
+
+register(JunieAdapter())
+
+__all__ = ["JunieAdapter"]

spawn_cli-0.1.22/src/spawn_cli/ide/mimo_code.py

@@ -0,0 +1,177 @@
+"""Mimo Code adapter: .mimocode/skills, .mimocode/mimocode.json (mcp + permission), AGENTS.md."""
+
+from __future__ import annotations
+
+import json
+import warnings
+from pathlib import Path
+
+from spawn_cli.core import low_level as ll
+from spawn_cli.errors import SpawnError, SpawnWarning
+from spawn_cli.ide import _vacancy as _vac
+from spawn_cli.ide.mcp_stdio_argv import mcp_stdio_argv
+from spawn_cli.ide.registry import (
+    DetectResult,
+    IdeAdapter,
+    IdeCapabilities,
+    normalize_skill_name,
+    register,
+    render_skill_md,
+    rewrite_managed_block,
+)
+from spawn_cli.models.mcp import McpServer, NormalizedMcp
+from spawn_cli.models.skill import SkillMetadata
+
+_CONFIG = Path(".mimocode") / "mimocode.json"
+
+
+def _load_config(target_root: Path) -> dict:
+    path = target_root / _CONFIG
+    if not path.exists():
+        if (target_root / ".mimocode" / "mimocode.jsonc").exists():
+            warnings.warn(
+                "Mimo Code: Spawn manages .mimocode/mimocode.json; existing mimocode.jsonc is not merged",
+                SpawnWarning,
+            )
+        return {}
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except json.JSONDecodeError as exc:
+        raise SpawnError(f"Mimo Code config is not valid JSON: {path} ({exc})") from exc
+
+
+def _save_config(target_root: Path, data: dict) -> None:
+    path = target_root / _CONFIG
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+
+
+def _build_mcp_entry(server: McpServer) -> dict:
+    transport = server.transport
+    if transport.type == "stdio":
+        if server.spawn_stdio_proxy:
+            entry = {
+                "type": "local",
+                "command": ["spawn"] + mcp_stdio_argv(server.extension, server.name),
+            }
+        else:
+            entry = {"type": "local", "command": [transport.command, *list(transport.args)]}
+    else:  # streamable-http and sse both render as remote
+        entry = {"type": "remote", "url": transport.url}
+        if transport.headers:
+            entry["headers"] = {k: f"{{env:{v}}}" for k, v in transport.headers.items()}
+    entry["enabled"] = True
+    if server.env:
+        entry["environment"] = {
+            k: f"{{env:{k}}}" if v.secret else (v.value or f"{{env:{k}}}")
+            for k, v in server.env.items()
+        }
+    return entry
+
+
+class MimoCodeAdapter(IdeAdapter):
+    key = "mimo-code"
+
+    def detect(self, target_root: Path) -> DetectResult:
+        used = (target_root / ".mimocode").exists()
+        return DetectResult(
+            used_in_repo=used,
+            capabilities=IdeCapabilities(
+                skills="native",
+                mcp="project",
+                agent_ignore="project",
+                entry_point="agents-md",
+            ),
+        )
+
+    def add_skills(self, target_root: Path, skill_metadata: list[SkillMetadata]) -> list[dict]:
+        results = []
+        for skill in skill_metadata:
+            name = normalize_skill_name(skill.name)
+            skill_dir = target_root / ".mimocode" / "skills" / name
+            skill_dir.mkdir(parents=True, exist_ok=True)
+            skill_path = skill_dir / "SKILL.md"
+            if skill_path.exists():
+                warnings.warn(f"Overwriting existing rendered skill: {skill_path}", SpawnWarning)
+            # Mimo Code requires frontmatter name == directory name.
+            rendered = render_skill_md(skill.model_copy(update={"name": name}))
+            skill_path.write_text(rendered, encoding="utf-8")
+            results.append({"skill": skill.name, "path": skill_path.relative_to(target_root).as_posix()})
+        return results
+
+    def remove_skills(self, target_root: Path, rendered_paths: list[dict]) -> None:
+        for entry in rendered_paths:
+            p = target_root / entry["path"]
+            if p.exists():
+                p.unlink()
+            if p.parent.exists() and not any(p.parent.iterdir()):
+                p.parent.rmdir()
+
+    def add_mcp(self, target_root: Path, normalized_mcp: NormalizedMcp) -> list[str]:
+        data = _load_config(target_root)
+        mcp = data.setdefault("mcp", {})
+        for server in normalized_mcp.servers:
+            mcp[server.name] = _build_mcp_entry(server)
+        _save_config(target_root, data)
+        return [s.name for s in normalized_mcp.servers]
+
+    def remove_mcp(self, target_root: Path, rendered_mcp_names: list[str]) -> None:
+        if not (target_root / _CONFIG).exists():
+            return
+        data = _load_config(target_root)
+        mcp = data.get("mcp")
+        if isinstance(mcp, dict):
+            for name in rendered_mcp_names:
+                mcp.pop(name, None)
+            if not mcp:
+                data.pop("mcp", None)
+        _save_config(target_root, data)
+
+    def add_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        data = _load_config(target_root)
+        perms = data.setdefault("permission", {})
+        for section in ("read", "edit"):
+            rules = perms.setdefault(section, {})
+            if not isinstance(rules, dict):
+                rules = {}
+                perms[section] = rules
+            for glob in globs:
+                rules[glob] = "deny"
+        _save_config(target_root, data)
+
+    def remove_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        if not (target_root / _CONFIG).exists():
+            return
+        data = _load_config(target_root)
+        perms = data.get("permission")
+        if not isinstance(perms, dict):
+            return
+        drop = set(globs)
+        for section in ("read", "edit"):
+            rules = perms.get(section)
+            if isinstance(rules, dict):
+                for glob in drop:
+                    rules.pop(glob, None)
+                if not rules:
+                    perms.pop(section, None)
+        if not perms:
+            data.pop("permission", None)
+        _save_config(target_root, data)
+
+    def clear_spawn_agent_ignore(self, target_root: Path) -> None:
+        recorded = ll.get_agent_ignore_list(target_root, self.key)
+        if recorded:
+            self.remove_agent_ignore(target_root, recorded)
+
+    def rewrite_entry_point(self, target_root: Path, prompt: str) -> str:
+        ep = target_root / "AGENTS.md"
+        rewrite_managed_block(ep, prompt)
+        return ep.relative_to(target_root).as_posix()
+
+    def finalize_repo_after_ide_removed(self, target_root: Path) -> None:
+        _vac.finalize_mimo_code_repo(target_root)
+
+
+register(MimoCodeAdapter())
+
+__all__ = ["MimoCodeAdapter"]

spawn_cli-0.1.22/src/spawn_cli/ide/opencode.py

@@ -0,0 +1,187 @@
+"""OpenCode CLI adapter: .opencode/skills, root opencode.json (mcp + permission), AGENTS.md."""
+
+from __future__ import annotations
+
+import json
+import re
+import warnings
+from pathlib import Path
+
+from spawn_cli.core import low_level as ll
+from spawn_cli.errors import SpawnError, SpawnWarning
+from spawn_cli.ide import _vacancy as _vac
+from spawn_cli.ide.mcp_stdio_argv import mcp_stdio_argv
+from spawn_cli.ide.registry import (
+    DetectResult,
+    IdeAdapter,
+    IdeCapabilities,
+    normalize_skill_name,
+    register,
+    render_skill_md,
+    rewrite_managed_block,
+)
+from spawn_cli.models.mcp import McpServer, NormalizedMcp
+from spawn_cli.models.skill import SkillMetadata
+
+_CONFIG = "opencode.json"
+
+
+def _load_config(target_root: Path) -> dict:
+    path = target_root / _CONFIG
+    if not path.exists():
+        if (target_root / "opencode.jsonc").exists():
+            warnings.warn(
+                "OpenCode: Spawn manages opencode.json; existing opencode.jsonc is not merged",
+                SpawnWarning,
+            )
+        return {}
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except json.JSONDecodeError as exc:
+        raise SpawnError(f"OpenCode config is not valid JSON: {path} ({exc})") from exc
+
+
+def _save_config(target_root: Path, data: dict) -> None:
+    (target_root / _CONFIG).write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+
+
+def _sanitize_skill_name(name: str) -> str:
+    name = normalize_skill_name(name)
+    name = name.replace("_", "-").replace(".", "-")
+    name = re.sub(r"-{2,}", "-", name).strip("-")
+    return name
+
+
+def _build_mcp_entry(server: McpServer) -> dict:
+    transport = server.transport
+    if transport.type == "stdio":
+        if server.spawn_stdio_proxy:
+            entry = {
+                "type": "local",
+                "command": ["spawn"] + mcp_stdio_argv(server.extension, server.name),
+            }
+        else:
+            entry = {"type": "local", "command": [transport.command, *list(transport.args)]}
+    else:  # streamable-http and sse both render as remote
+        entry = {"type": "remote", "url": transport.url}
+        if transport.headers:
+            entry["headers"] = {k: f"{{env:{v}}}" for k, v in transport.headers.items()}
+    entry["enabled"] = True
+    if server.env:
+        entry["environment"] = {
+            k: f"{{env:{k}}}" if v.secret else (v.value or f"{{env:{k}}}")
+            for k, v in server.env.items()
+        }
+    return entry
+
+
+class OpenCodeAdapter(IdeAdapter):
+    key = "opencode"
+
+    def detect(self, target_root: Path) -> DetectResult:
+        used = (
+            (target_root / ".opencode").exists()
+            or (target_root / "opencode.json").exists()
+            or (target_root / "opencode.jsonc").exists()
+        )
+        return DetectResult(
+            used_in_repo=used,
+            capabilities=IdeCapabilities(
+                skills="native",
+                mcp="project",
+                agent_ignore="project",
+                entry_point="agents-md",
+            ),
+        )
+
+    def add_skills(self, target_root: Path, skill_metadata: list[SkillMetadata]) -> list[dict]:
+        results = []
+        for skill in skill_metadata:
+            name = _sanitize_skill_name(skill.name)
+            skill_dir = target_root / ".opencode" / "skills" / name
+            skill_dir.mkdir(parents=True, exist_ok=True)
+            skill_path = skill_dir / "SKILL.md"
+            if skill_path.exists():
+                warnings.warn(f"Overwriting existing rendered skill: {skill_path}", SpawnWarning)
+            # OpenCode requires frontmatter name == directory name.
+            rendered = render_skill_md(skill.model_copy(update={"name": name}))
+            skill_path.write_text(rendered, encoding="utf-8")
+            results.append({"skill": skill.name, "path": skill_path.relative_to(target_root).as_posix()})
+        return results
+
+    def remove_skills(self, target_root: Path, rendered_paths: list[dict]) -> None:
+        for entry in rendered_paths:
+            p = target_root / entry["path"]
+            if p.exists():
+                p.unlink()
+            if p.parent.exists() and not any(p.parent.iterdir()):
+                p.parent.rmdir()
+
+    def add_mcp(self, target_root: Path, normalized_mcp: NormalizedMcp) -> list[str]:
+        data = _load_config(target_root)
+        mcp = data.setdefault("mcp", {})
+        for server in normalized_mcp.servers:
+            mcp[server.name] = _build_mcp_entry(server)
+        _save_config(target_root, data)
+        return [s.name for s in normalized_mcp.servers]
+
+    def remove_mcp(self, target_root: Path, rendered_mcp_names: list[str]) -> None:
+        if not (target_root / _CONFIG).exists():
+            return
+        data = _load_config(target_root)
+        mcp = data.get("mcp")
+        if isinstance(mcp, dict):
+            for name in rendered_mcp_names:
+                mcp.pop(name, None)
+            if not mcp:
+                data.pop("mcp", None)
+        _save_config(target_root, data)
+
+    def add_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        data = _load_config(target_root)
+        perms = data.setdefault("permission", {})
+        for section in ("read", "edit"):
+            rules = perms.setdefault(section, {})
+            if not isinstance(rules, dict):
+                rules = {}
+                perms[section] = rules
+            for glob in globs:
+                rules[glob] = "deny"
+        _save_config(target_root, data)
+
+    def remove_agent_ignore(self, target_root: Path, globs: list[str]) -> None:
+        if not (target_root / _CONFIG).exists():
+            return
+        data = _load_config(target_root)
+        perms = data.get("permission")
+        if not isinstance(perms, dict):
+            return
+        drop = set(globs)
+        for section in ("read", "edit"):
+            rules = perms.get(section)
+            if isinstance(rules, dict):
+                for glob in drop:
+                    rules.pop(glob, None)
+                if not rules:
+                    perms.pop(section, None)
+        if not perms:
+            data.pop("permission", None)
+        _save_config(target_root, data)
+
+    def clear_spawn_agent_ignore(self, target_root: Path) -> None:
+        recorded = ll.get_agent_ignore_list(target_root, self.key)
+        if recorded:
+            self.remove_agent_ignore(target_root, recorded)
+
+    def rewrite_entry_point(self, target_root: Path, prompt: str) -> str:
+        ep = target_root / "AGENTS.md"
+        rewrite_managed_block(ep, prompt)
+        return ep.relative_to(target_root).as_posix()
+
+    def finalize_repo_after_ide_removed(self, target_root: Path) -> None:
+        _vac.finalize_opencode_repo(target_root)
+
+
+register(OpenCodeAdapter())
+
+__all__ = ["OpenCodeAdapter"]

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/src/spawn_cli/ide/registry.py

@@ -102,6 +102,7 @@ ALIASES: dict[str, str] = {
     "gemini": "gemini-cli",
     "copilot": "github-copilot",
     "github": "github-copilot",
+    "mimo": "mimo-code",
 }
 
 _registry: dict[str, IdeAdapter] = {}  # populated at module load by adapter modules

{spawn_cli-0.1.20 → spawn_cli-0.1.22/src/spawn_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawn-cli
-Version: 0.1.20
+Version: 0.1.22
 Summary: A minimal installable Python CLI package.
 License: MIT
 Classifier: License :: OSI Approved :: MIT License
@@ -240,14 +240,40 @@ read-required:
 
 Then run **`spawn refresh`** so skills and entry points pick up the hint.
 
-## License
+### Supported IDEs
 
-MIT — see [LICENSE](LICENSE).
+| IDE (key) | Skills | MCP | Agent ignore | Entry point | Detection markers |
+| --- | --- | --- | --- | --- | --- |
+| Cursor (`cursor`) | `.cursor/skills/` | `.cursor/mcp.json` | `.cursorignore` | `AGENTS.md` | `.cursor/` |
+| Codex (`codex`) | `.agents/skills/` | `.codex/config.toml` | `config.toml` permissions | `AGENTS.md` | `.codex/`, `.agents/` |
+| Claude Code (`claude-code`) | `.claude/skills/` | `.mcp.json` | `.claude/settings.json` | `CLAUDE.md` | `.claude/`, `CLAUDE.md` |
+| Windsurf (`windsurf`) | `.windsurf/skills/` | — | `.codeiumignore` | `AGENTS.md` | `.windsurf/`, `.codeiumignore` |
+| GitHub Copilot (`github-copilot`) | `.github/skills/` | `.vscode/mcp.json` | — | `.github/copilot-instructions.md`, `AGENTS.md` | `.github/`, `.vscode/` |
+| Gemini CLI (`gemini-cli`) | `.gemini/skills/` | `.gemini/settings.json` | `.geminiignore` | `GEMINI.md` | `.gemini/`, `GEMINI.md` |
+| Cline (`cline`) | `.cline/skills/` | — | `.clineignore` | `AGENTS.md` | `.cline/`, `.clinerules`, `.clineignore` |
+| OpenCode (`opencode`) | `.opencode/skills/` | `opencode.json` | `opencode.json` permissions | `AGENTS.md` | `.opencode/`, `opencode.json`, `opencode.jsonc` |
+| Mimo Code (`mimo-code`) | `.mimocode/skills/` | `.mimocode/mimocode.json` | `mimocode.json` permissions | `AGENTS.md` | `.mimocode/` |
+| Hermes (`hermes`) | `.hermes/skills/` | — | — | `.hermes.md` | `.hermes/`, `.hermes.md`, `HERMES.md` |
+| JetBrains Junie (`junie`) | `.junie/skills/` | `.junie/mcp/mcp.json` | `.aiignore` | `AGENTS.md` | `.junie/` |
 
----
+**Legend:**
+
+- **Skills** — project directory where spawn renders `SKILL.md` per skill (`native` capability; frontmatter `name` matches the directory name).
+- **MCP** — project-scope config file where spawn merges extension MCP servers. "—" means the tool keeps MCP global-only (e.g. `~/.hermes/config.yaml`); spawn warns (`SpawnWarning`) and writes nothing.
+- **Agent ignore** — where spawn merges agent-ignore globs: a dedicated ignore file, or permissions entries in the project config (managed block / spawn-owned entries only; removal never touches user rules). "—" means no upstream ignore mechanism; spawn warns and skips.
+- **Entry point** — file(s) receiving the Spawn-managed instruction block (`<!-- spawn:start -->` ... `<!-- spawn:end -->`); user content around the block is preserved.
+- **Detection markers** — files/directories that make `spawn ide list-supported-ides` (and auto-detection) mark the IDE as used in the repo.
+
+Full per-IDE contracts (config shapes, ignore semantics, caveats): [spec/design/ide-adapters.md](spec/design/ide-adapters.md).
 
 P.S. Below is a diagram that might help you understand how Spawn works.
 
 <p align="center">
   <img src="logo/Scheme.png" alt="How Spawn works" />
 </p>
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{spawn_cli-0.1.20 → spawn_cli-0.1.22}/src/spawn_cli.egg-info/SOURCES.txt

@@ -28,7 +28,11 @@ src/spawn_cli/ide/codex.py
 src/spawn_cli/ide/cursor.py
 src/spawn_cli/ide/gemini_cli.py
 src/spawn_cli/ide/github_copilot.py
+src/spawn_cli/ide/hermes.py
+src/spawn_cli/ide/junie.py
 src/spawn_cli/ide/mcp_stdio_argv.py
+src/spawn_cli/ide/mimo_code.py
+src/spawn_cli/ide/opencode.py
 src/spawn_cli/ide/registry.py
 src/spawn_cli/ide/windsurf.py
 src/spawn_cli/io/__init__.py