agent-brain-cli 8.0.0__tar.gz → 9.2.0__tar.gz

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agent-brain-cli
-Version: 8.0.0
+Version: 9.2.0
 Summary: Agent Brain CLI - Command-line interface for managing AI agent memory and knowledge retrieval
 Home-page: https://github.com/SpillwaveSolutions/agent-brain
 License: MIT
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: agent-brain-rag (>=8.0.0,<9.0.0)
+Requires-Dist: agent-brain-rag (>=9.2.0,<10.0.0)
 Requires-Dist: click (>=8.1.0,<9.0.0)
 Requires-Dist: httpx (>=0.28.0,<0.29.0)
 Requires-Dist: pydantic (>=2.10.0,<3.0.0)

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/__init__.py

@@ -1,3 +1,3 @@
 """Doc-Serve CLI - Command-line interface for managing Doc-Serve server."""
 
-__version__ = "8.0.0"
+__version__ = "9.2.0"

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/cli.py

@@ -14,6 +14,7 @@ from .commands import (
     index_command,
     init_command,
     inject_command,
+    install_agent_command,
     jobs_command,
     list_command,
     query_command,
@@ -101,6 +102,7 @@ cli.add_command(folders_group, name="folders")
 cli.add_command(types_group, name="types")
 cli.add_command(cache_group, name="cache")
 cli.add_command(uninstall_command, name="uninstall")
+cli.add_command(install_agent_command, name="install-agent")
 
 
 if __name__ == "__main__":

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/commands/__init__.py

@@ -6,6 +6,7 @@ from .folders import folders_group
 from .index import index_command
 from .init import init_command
 from .inject import inject_command
+from .install_agent import install_agent_command
 from .jobs import jobs_command
 from .list_cmd import list_command
 from .query import query_command
@@ -23,6 +24,7 @@ __all__ = [
     "index_command",
     "inject_command",
     "init_command",
+    "install_agent_command",
     "jobs_command",
     "list_command",
     "query_command",

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/commands/config.py

@@ -22,7 +22,7 @@ def _find_config_file() -> Path | None:
     1. AGENT_BRAIN_CONFIG environment variable
     2. State directory config.yaml (if AGENT_BRAIN_STATE_DIR set)
     3. Current directory config.yaml
-    4. Walk up from CWD looking for .claude/agent-brain/config.yaml
+    4. Walk up from CWD: .agent-brain/config.yaml (or legacy path)
     5. XDG config ~/.config/agent-brain/config.yaml (preferred)
     6. Legacy ~/.agent-brain/config.yaml (deprecated, prints warning)
 
@@ -48,13 +48,16 @@ def _find_config_file() -> Path | None:
     if cwd_config.exists():
         return cwd_config
 
-    # 4. Walk up from CWD
+    # 4. Walk up from CWD looking for .agent-brain/ or legacy .claude/agent-brain/
     current = Path.cwd()
     root = Path(current.anchor)
     while current != root:
-        claude_config = current / ".claude" / "agent-brain" / "config.yaml"
-        if claude_config.exists():
-            return claude_config
+        new_config = current / ".agent-brain" / "config.yaml"
+        if new_config.exists():
+            return new_config
+        legacy_config = current / ".claude" / "agent-brain" / "config.yaml"
+        if legacy_config.exists():
+            return legacy_config
         current = current.parent
 
     # 5. XDG config (checked before legacy per XDG standard)

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/commands/init.py

@@ -7,6 +7,7 @@ import click
 from rich.console import Console
 from rich.panel import Panel
 
+from agent_brain_cli.migration import migrate_state_dir
 from agent_brain_cli.xdg_paths import migrate_legacy_paths
 
 console = Console()
@@ -33,7 +34,7 @@ DEFAULT_CONFIG = {
     ],
 }
 
-STATE_DIR_NAME = ".claude/agent-brain"
+STATE_DIR_NAME = ".agent-brain"
 
 
 def resolve_project_root(start_path: Path | None = None) -> Path:
@@ -72,6 +73,8 @@ def resolve_project_root(start_path: Path | None = None) -> Path:
     # Walk up looking for markers
     current = start
     while current != current.parent:
+        if (current / ".agent-brain").is_dir():
+            return current
         if (current / ".claude").is_dir():
             return current
         if (current / "pyproject.toml").is_file():
@@ -110,7 +113,7 @@ def resolve_project_root(start_path: Path | None = None) -> Path:
     "--state-dir",
     "-s",
     type=click.Path(file_okay=False, resolve_path=True),
-    help="Custom state directory for index data (default: .claude/agent-brain)",
+    help="Custom state directory for index data (default: .agent-brain)",
 )
 def init_command(
     path: str | None,
@@ -122,7 +125,7 @@ def init_command(
 ) -> None:
     """Initialize a new Agent Brain project.
 
-    Creates the .claude/agent-brain/ directory structure and writes
+    Creates the .agent-brain/ directory structure and writes
     a default config.json file.
 
     \b
@@ -147,7 +150,8 @@ def init_command(
         if state_dir:
             resolved_state_dir = Path(state_dir).resolve()
         else:
-            resolved_state_dir = project_root / STATE_DIR_NAME
+            # Auto-migrate from legacy .claude/agent-brain if needed
+            resolved_state_dir = migrate_state_dir(project_root)
         config_path = resolved_state_dir / "config.json"
 
         # Check for existing configuration

agent_brain_cli-9.2.0/agent_brain_cli/commands/install_agent.py

@@ -0,0 +1,340 @@
+"""Install-agent command for installing runtime-specific plugin files."""
+
+import json
+from pathlib import Path
+from typing import Any
+
+import click
+from rich.console import Console
+from rich.panel import Panel
+
+from agent_brain_cli.runtime.claude_converter import ClaudeConverter
+from agent_brain_cli.runtime.codex_converter import CodexConverter
+from agent_brain_cli.runtime.gemini_converter import GeminiConverter
+from agent_brain_cli.runtime.opencode_converter import OpenCodeConverter
+from agent_brain_cli.runtime.parser import parse_plugin_dir
+from agent_brain_cli.runtime.skill_runtime_converter import SkillRuntimeConverter
+from agent_brain_cli.runtime.types import Scope
+
+console = Console()
+
+# Default install directories per runtime and scope
+INSTALL_DIRS: dict[str, dict[str, str]] = {
+    "claude": {
+        "project": ".claude/plugins/agent-brain",
+        "global": "~/.claude/plugins/agent-brain",
+    },
+    "opencode": {
+        "project": ".opencode/plugins/agent-brain",
+        "global": "~/.config/opencode/plugins/agent-brain",
+    },
+    "gemini": {
+        "project": ".gemini/plugins/agent-brain",
+        "global": "~/.config/gemini/plugins/agent-brain",
+    },
+    "codex": {
+        "project": ".codex/skills/agent-brain",
+        "global": "~/.codex/skills/agent-brain",
+    },
+}
+
+# Runtimes that require --dir (no default directory)
+DIR_REQUIRED_RUNTIMES = {"skill-runtime"}
+
+ConverterType = type[
+    ClaudeConverter
+    | OpenCodeConverter
+    | GeminiConverter
+    | SkillRuntimeConverter
+    | CodexConverter
+]
+
+CONVERTERS: dict[str, ConverterType] = {
+    "claude": ClaudeConverter,
+    "opencode": OpenCodeConverter,
+    "gemini": GeminiConverter,
+    "skill-runtime": SkillRuntimeConverter,
+    "codex": CodexConverter,
+}
+
+
+def _find_plugin_dir() -> Path | None:
+    """Find the canonical plugin directory.
+
+    Searches for agent-brain-plugin in common locations.
+    """
+    # Check relative to this package (development layout)
+    pkg_dir = Path(__file__).parent.parent.parent.parent
+    candidate = pkg_dir / "agent-brain-plugin"
+    if candidate.is_dir() and (candidate / "commands").is_dir():
+        return candidate
+
+    # Check installed location
+    installed = Path.home() / ".claude" / "plugins" / "agent-brain"
+    if installed.is_dir() and (installed / "commands").is_dir():
+        return installed
+
+    return None
+
+
+def _resolve_target_dir(
+    runtime: str,
+    scope: str,
+    project_root: Path | None = None,
+    custom_dir: str | None = None,
+) -> Path:
+    """Resolve the target installation directory."""
+    if custom_dir:
+        return Path(custom_dir).expanduser().resolve()
+    dir_template = INSTALL_DIRS[runtime][scope]
+    if scope == "global":
+        return Path(dir_template).expanduser()
+    if project_root is None:
+        project_root = Path.cwd()
+    return project_root / dir_template
+
+
+RUNTIME_CHOICES = ["claude", "opencode", "gemini", "skill-runtime", "codex"]
+
+
+@click.command("install-agent")
+@click.option(
+    "--agent",
+    "-a",
+    required=True,
+    type=click.Choice(RUNTIME_CHOICES),
+    help="Target runtime to install for",
+)
+@click.option(
+    "--project",
+    "scope",
+    flag_value="project",
+    default=True,
+    help="Install to project directory (default)",
+)
+@click.option(
+    "--global",
+    "scope",
+    flag_value="global",
+    help="Install to user-level directory",
+)
+@click.option(
+    "--plugin-dir",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Custom canonical plugin source directory",
+)
+@click.option(
+    "--dir",
+    "target_dir_option",
+    type=click.Path(resolve_path=True),
+    help="Target skill directory (required for skill-runtime)",
+)
+@click.option(
+    "--dry-run",
+    is_flag=True,
+    help="List files that would be created without writing",
+)
+@click.option(
+    "--json",
+    "json_output",
+    is_flag=True,
+    help="Output as JSON",
+)
+@click.option(
+    "--path",
+    "-p",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Project path for --project scope (default: cwd)",
+)
+def install_agent_command(
+    agent: str,
+    scope: str,
+    plugin_dir: str | None,
+    target_dir_option: str | None,
+    dry_run: bool,
+    json_output: bool,
+    path: str | None,
+) -> None:
+    """Install Agent Brain plugin for a specific runtime.
+
+    Converts the canonical plugin format into the target runtime's
+    native format and installs it.
+
+    \b
+    Examples:
+      agent-brain install-agent --agent claude --project
+      agent-brain install-agent --agent opencode --global
+      agent-brain install-agent --agent gemini --dry-run
+      agent-brain install-agent --agent skill-runtime --dir ./my-skills
+      agent-brain install-agent --agent codex
+    """
+    try:
+        # Validate --dir requirement for skill-runtime
+        if agent in DIR_REQUIRED_RUNTIMES and not target_dir_option:
+            msg = (
+                f"--dir is required for --agent {agent}. "
+                "Specify the target skill directory."
+            )
+            if json_output:
+                click.echo(json.dumps({"error": msg}))
+            else:
+                console.print(f"[red]Error:[/] {msg}")
+            raise SystemExit(1)
+
+        # Resolve plugin source directory
+        source: Path
+        if plugin_dir:
+            source = Path(plugin_dir)
+        else:
+            found = _find_plugin_dir()
+            if found is None:
+                msg = (
+                    "Could not find canonical plugin directory. "
+                    "Use --plugin-dir to specify location."
+                )
+                if json_output:
+                    click.echo(json.dumps({"error": msg}))
+                else:
+                    console.print(f"[red]Error:[/] {msg}")
+                raise SystemExit(1)
+            source = found
+
+        # Parse the plugin
+        bundle = parse_plugin_dir(source)
+
+        if not json_output and not dry_run:
+            console.print(
+                f"[dim]Parsed {len(bundle.commands)} commands, "
+                f"{len(bundle.agents)} agents, "
+                f"{len(bundle.skills)} skills, "
+                f"{len(bundle.templates)} templates, "
+                f"{len(bundle.scripts)} scripts[/]"
+            )
+
+        # Resolve target directory
+        project_root = Path(path) if path else None
+        target = _resolve_target_dir(agent, scope, project_root, target_dir_option)
+
+        # Create converter
+        converter_cls = CONVERTERS[agent]
+        converter = converter_cls()
+        scope_enum = Scope.GLOBAL if scope == "global" else Scope.PROJECT
+
+        if dry_run:
+            _handle_dry_run(
+                converter,
+                bundle,
+                target,
+                scope_enum,
+                agent,
+                scope,
+                json_output,
+            )
+            return
+
+        # Actually install
+        if isinstance(converter, CodexConverter):
+            codex_root = Path(path) if path else Path.cwd()
+            files = converter.install(
+                bundle, target, scope_enum, project_root=codex_root
+            )
+        else:
+            files = converter.install(bundle, target, scope_enum)
+
+        if json_output:
+            result: dict[str, Any] = {
+                "status": "installed",
+                "agent": agent,
+                "scope": scope,
+                "target_dir": str(target),
+                "files_created": len(files),
+                "source_dir": str(source),
+            }
+            click.echo(json.dumps(result, indent=2))
+        else:
+            console.print(
+                Panel(
+                    f"[green]Plugin installed successfully![/]\n\n"
+                    f"[bold]Runtime:[/] {agent}\n"
+                    f"[bold]Scope:[/] {scope}\n"
+                    f"[bold]Target:[/] {target}\n"
+                    f"[bold]Files:[/] {len(files)}",
+                    title="Agent Brain Installed",
+                    border_style="green",
+                )
+            )
+
+    except SystemExit:
+        raise
+    except Exception as exc:
+        if json_output:
+            click.echo(json.dumps({"error": str(exc)}))
+        else:
+            console.print(f"[red]Error:[/] {exc}")
+        raise SystemExit(1) from exc
+
+
+def _handle_dry_run(
+    converter: (
+        ClaudeConverter
+        | OpenCodeConverter
+        | GeminiConverter
+        | SkillRuntimeConverter
+        | CodexConverter
+    ),
+    bundle: Any,
+    target: Path,
+    scope_enum: Scope,
+    agent: str,
+    scope: str,
+    json_output: bool,
+) -> None:
+    """Handle dry-run mode: simulate install in temp dir."""
+    import tempfile
+
+    with tempfile.TemporaryDirectory() as tmp:
+        tmp_target = Path(tmp)
+        # For Codex, pass tmp as project_root so AGENTS.md lands in tmpdir
+        if isinstance(converter, CodexConverter):
+            files = converter.install(
+                bundle, tmp_target, scope_enum, project_root=Path(tmp)
+            )
+        else:
+            files = converter.install(bundle, tmp_target, scope_enum)
+        # Remap paths to real target
+        planned: list[Path] = []
+        for f in files:
+            try:
+                planned.append(target / f.relative_to(tmp_target))
+            except ValueError:
+                # AGENTS.md may be at project_root, not under target
+                planned.append(f)
+
+    if json_output:
+        click.echo(
+            json.dumps(
+                {
+                    "dry_run": True,
+                    "agent": agent,
+                    "scope": scope,
+                    "target_dir": str(target),
+                    "files": [str(f) for f in planned],
+                    "file_count": len(planned),
+                },
+                indent=2,
+            )
+        )
+    else:
+        console.print(
+            Panel(
+                f"[yellow]Dry run[/] — no files written\n\n"
+                f"[bold]Runtime:[/] {agent}\n"
+                f"[bold]Scope:[/] {scope}\n"
+                f"[bold]Target:[/] {target}\n"
+                f"[bold]Files:[/] {len(planned)}",
+                title="Install Preview",
+                border_style="yellow",
+            )
+        )
+        for f in planned:
+            console.print(f"  [dim]{f}[/]")

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/commands/start.py

@@ -15,11 +15,12 @@ import click
 from rich.console import Console
 from rich.panel import Panel
 
+from agent_brain_cli.migration import resolve_state_dir_with_fallback
 from agent_brain_cli.xdg_paths import get_xdg_state_dir, migrate_legacy_paths
 
 console = Console()
 
-STATE_DIR_NAME = ".claude/agent-brain"
+STATE_DIR_NAME = ".agent-brain"
 LOCK_FILE = "agent-brain.lock"
 PID_FILE = "agent-brain.pid"
 RUNTIME_FILE = "runtime.json"
@@ -46,6 +47,8 @@ def resolve_project_root(start_path: Path | None = None) -> Path:
     # Walk up looking for markers
     current = start
     while current != current.parent:
+        if (current / ".agent-brain").is_dir():
+            return current
         if (current / ".claude").is_dir():
             return current
         if (current / "pyproject.toml").is_file():
@@ -234,7 +237,7 @@ def start_command(
         else:
             project_root = resolve_project_root()
 
-        state_dir = project_root / STATE_DIR_NAME
+        state_dir = resolve_state_dir_with_fallback(project_root)
 
         # Check if initialized
         if not state_dir.exists():

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/commands/stop.py

@@ -12,11 +12,12 @@ from urllib.request import Request, urlopen
 import click
 from rich.console import Console
 
+from agent_brain_cli.migration import resolve_state_dir_with_fallback
 from agent_brain_cli.xdg_paths import get_registry_path
 
 console = Console()
 
-STATE_DIR_NAME = ".claude/agent-brain"
+STATE_DIR_NAME = ".agent-brain"
 LOCK_FILE = "agent-brain.lock"
 PID_FILE = "agent-brain.pid"
 RUNTIME_FILE = "runtime.json"
@@ -43,6 +44,8 @@ def resolve_project_root(start_path: Path | None = None) -> Path:
     # Walk up looking for markers
     current = start
     while current != current.parent:
+        if (current / ".agent-brain").is_dir():
+            return current
         if (current / ".claude").is_dir():
             return current
         if (current / "pyproject.toml").is_file():
@@ -181,7 +184,7 @@ def stop_command(
         else:
             project_root = resolve_project_root()
 
-        state_dir = project_root / STATE_DIR_NAME
+        state_dir = resolve_state_dir_with_fallback(project_root)
 
         # Check if state directory exists
         if not state_dir.exists():

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/commands/uninstall.py

@@ -102,7 +102,7 @@ def uninstall_command(yes: bool, json_output: bool) -> None:
       - ~/.local/state/agent-brain/  (XDG state directory)
       - ~/.agent-brain/           (legacy directory, if present)
 
-    Does NOT remove project-level .claude/agent-brain/ directories.
+    Does NOT remove project-level .agent-brain/ directories.
 
     \b
     Examples:

{agent_brain_cli-8.0.0 → agent_brain_cli-9.2.0}/agent_brain_cli/config.py

@@ -18,7 +18,8 @@ from agent_brain_cli.xdg_paths import get_xdg_config_dir
 logger = logging.getLogger(__name__)
 
 # Default state directory name within project root
-STATE_DIR_NAME = ".claude/agent-brain"
+STATE_DIR_NAME = ".agent-brain"
+LEGACY_STATE_DIR_NAME = ".claude/agent-brain"
 
 
 class ServerConfig(BaseModel):
@@ -47,7 +48,7 @@ class ProjectConfig(BaseModel):
 
     state_dir: str | None = Field(
         default=None,
-        description="Custom state directory path (default: .claude/agent-brain)",
+        description="Custom state directory path (default: .agent-brain)",
     )
     project_root: str | None = Field(
         default=None,
@@ -120,7 +121,7 @@ def _find_config_file(start_path: Path | None = None) -> Path | None:
     Search order:
     1. AGENT_BRAIN_CONFIG environment variable
     2. Current directory: agent-brain.yaml or config.yaml
-    3. Project .claude/agent-brain/config.yaml
+    3. Project .agent-brain/config.yaml (or legacy .claude/agent-brain/)
     4. User home: ~/.agent-brain/config.yaml
     5. User home: ~/.config/agent-brain/config.yaml (XDG)
 
@@ -148,14 +149,18 @@ def _find_config_file(start_path: Path | None = None) -> Path | None:
             logger.debug(f"Using config from current directory: {cwd_config}")
             return cwd_config
 
-    # 3. Project .claude/agent-brain directory
-    # Walk up looking for .claude directory
+    # 3. Project .agent-brain directory (or legacy .claude/agent-brain)
+    # Walk up looking for state directory
     current = start
     while current != current.parent:
-        claude_config = current / ".claude" / "agent-brain" / "config.yaml"
-        if claude_config.exists():
-            logger.debug(f"Using config from project: {claude_config}")
-            return claude_config
+        new_config = current / ".agent-brain" / "config.yaml"
+        if new_config.exists():
+            logger.debug(f"Using config from project: {new_config}")
+            return new_config
+        legacy_config = current / ".claude" / "agent-brain" / "config.yaml"
+        if legacy_config.exists():
+            logger.debug(f"Using config from project: {legacy_config}")
+            return legacy_config
         current = current.parent
 
     # 4. XDG config (checked before legacy per XDG standard)
@@ -281,6 +286,8 @@ def _find_project_root(start_path: Path | None = None) -> Path:
     # Walk up looking for markers
     current = start
     while current != current.parent:
+        if (current / ".agent-brain").is_dir():
+            return current
         if (current / ".claude").is_dir():
             return current
         if (current / "pyproject.toml").is_file():
@@ -297,10 +304,10 @@ def get_state_dir(
     """Get the resolved state directory path.
 
     Resolution order:
-    1. Detect project root and check for .claude/agent-brain/
+    1. Detect project root and check for .agent-brain/ (or legacy .claude/agent-brain/)
     2. config.project.state_dir from config file
     3. AGENT_BRAIN_STATE_DIR environment variable (explicit override)
-    4. Default: {project_root}/.claude/agent-brain
+    4. Default: {project_root}/.agent-brain
 
     Args:
         config: Optional pre-loaded config.
@@ -313,9 +320,14 @@ def get_state_dir(
     if project_root is None:
         project_root = _find_project_root()
 
-    detected_state_dir = project_root / STATE_DIR_NAME
-    if detected_state_dir.exists() and (detected_state_dir / "config.json").exists():
-        return detected_state_dir
+    # Check new path first, then legacy
+    new_state_dir = project_root / STATE_DIR_NAME
+    if new_state_dir.exists() and (new_state_dir / "config.json").exists():
+        return new_state_dir
+
+    legacy_state_dir = project_root / LEGACY_STATE_DIR_NAME
+    if legacy_state_dir.exists() and (legacy_state_dir / "config.json").exists():
+        return legacy_state_dir
 
     # 2. Check config file setting
     if config is None:
@@ -329,7 +341,7 @@ def get_state_dir(
     if env_state_dir:
         return Path(env_state_dir).expanduser().resolve()
 
-    # 4. Default: project_root/.claude/agent-brain
+    # 4. Default: project_root/.agent-brain
     return project_root / STATE_DIR_NAME