Merge pull request #13 from zhujian0805/main

adding support of prompt, agent and MCP for opencode

Author: zhujian0805

code_assistant_manager/agents/__init__.py

@@ -7,6 +7,7 @@
 - Gemini: ~/.gemini/agents/
 - Droid: ~/.factory/agents/
 - CodeBuddy: ~/.codebuddy/agents/
+- OpenCode: ~/.config/opencode/agent/
 
 Reference: https://github.com/iannuttall/claude-agents
 """
@@ -18,9 +19,19 @@
 from .copilot import CopilotAgentHandler
 from .droid import DroidAgentHandler
 from .gemini import GeminiAgentHandler
-from .manager import VALID_APP_TYPES, AgentManager
+from .opencode import OpenCodeAgentHandler
+from .manager import VALID_APP_TYPES, AgentManager, AGENT_HANDLERS
 from .models import Agent, AgentRepo
 
+
+def get_handler(app_type: str) -> BaseAgentHandler:
+    """Get an agent handler instance for the specified app type."""
+    handler_class = AGENT_HANDLERS.get(app_type)
+    if not handler_class:
+        raise ValueError(f"Unknown app type: {app_type}. Valid: {VALID_APP_TYPES}")
+    return handler_class()
+
+
 __all__ = [
     "Agent",
     "AgentRepo",
@@ -32,5 +43,7 @@
     "DroidAgentHandler",
     "CodebuddyAgentHandler",
     "CopilotAgentHandler",
+    "OpenCodeAgentHandler",
+    "get_handler",
     "VALID_APP_TYPES",
 ]

code_assistant_manager/agents/manager.py

@@ -17,6 +17,7 @@
 from .copilot import CopilotAgentHandler
 from .droid import DroidAgentHandler
 from .gemini import GeminiAgentHandler
+from .opencode import OpenCodeAgentHandler
 from .models import Agent, AgentRepo
 
 logger = logging.getLogger(__name__)
@@ -66,6 +67,7 @@ def _load_builtin_agent_repos() -> List[Dict]:
     "droid": DroidAgentHandler,
     "codebuddy": CodebuddyAgentHandler,
     "copilot": CopilotAgentHandler,
+    "opencode": OpenCodeAgentHandler,
 }
 
 # Valid app types for agents

code_assistant_manager/agents/opencode.py

@@ -0,0 +1,23 @@
+"""OpenCode agent handler."""
+
+from pathlib import Path
+from typing import Optional
+
+from .base import BaseAgentHandler
+
+
+class OpenCodeAgentHandler(BaseAgentHandler):
+    """Agent handler for OpenCode.
+
+    OpenCode agents are markdown files stored in:
+    - Global: ~/.config/opencode/agent/
+    - Project: .opencode/agent/
+    """
+
+    @property
+    def app_name(self) -> str:
+        return "opencode"
+
+    @property
+    def _default_agents_dir(self) -> Path:
+        return Path.home() / ".config" / "opencode" / "agent"

code_assistant_manager/cli/agents_commands.py

@@ -30,7 +30,7 @@
     "claude",
     "--app",
     "-a",
-    help="App type(s) to install to (claude, codex, gemini, droid, codebuddy, all). Comma-separated.",
+    help="App type(s) to install to (claude, codex, gemini, droid, codebuddy, opencode, all). Comma-separated.",
 )
 FORCE_OPTION = typer.Option(False, "--force", "-f", help="Skip confirmation")
 OWNER_OPTION = typer.Option(..., "--owner", "-o", help="Repository owner")
@@ -43,20 +43,20 @@
     None,
     "--app",
     "-a",
-    help="App type(s) to show (claude, codex, gemini, droid, codebuddy, all). Default shows all.",
+    help="App type(s) to show (claude, codex, gemini, droid, codebuddy, opencode, all). Default shows all.",
 )
 APP_TYPE_OPTION_UNINSTALL = typer.Option(
     ...,
     "--app",
     "-a",
-    help="App type(s) to uninstall all agents from (claude, codex, gemini, droid, codebuddy, all). Comma-separated.",
+    help="App type(s) to uninstall all agents from (claude, codex, gemini, droid, codebuddy, opencode, all). Comma-separated.",
 )
 from code_assistant_manager.plugins.fetch import parse_github_url
 
 logger = logging.getLogger(__name__)
 
 agent_app = typer.Typer(
-    help="Manage agents for AI assistants (Claude, Codex, Gemini, Droid, CodeBuddy)",
+    help="Manage agents for AI assistants (Claude, Codex, Gemini, Droid, CodeBuddy, OpenCode)",
     no_args_is_help=True,
 )
 

code_assistant_manager/cli/prompts_commands.py

@@ -12,7 +12,7 @@
 logger = logging.getLogger(__name__)
 
 prompt_app = typer.Typer(
-    help="Manage prompts for AI assistants (Claude, Codex, Gemini, Copilot, CodeBuddy)",
+    help="Manage prompts for AI assistants (Claude, Codex, Gemini, Copilot, CodeBuddy, OpenCode)",
     no_args_is_help=True,
 )
 
@@ -332,7 +332,7 @@ def remove_prompt(
 @prompt_app.command("import")
 def import_prompt(
     name: Optional[str] = typer.Argument(None, help="Name for the imported prompt (auto-generated if not provided)"),
-    app: str = typer.Option(..., "--app", "-a", help=f"App to import from ({', '.join(VALID_APP_TYPES)})"),
+    app: str = typer.Option(..., "--app", "-a", help=f"App to import from ({', '.join(VALID_APP_TYPES)}) - Note: opencode prompt = rules"),
     level: str = typer.Option("user", "--level", "-l", help="Level: user or project"),
     project_dir: Optional[Path] = typer.Option(None, "--project-dir", "-d", help="Project directory (for project level)"),
     description: Optional[str] = typer.Option(None, "--description", help="Description of the prompt"),
@@ -420,7 +420,7 @@ def import_prompt(
 @prompt_app.command("install")
 def install_prompt(
     name: str = typer.Argument(..., help="Prompt name to install"),
-    app: str = typer.Option(..., "--app", "-a", help=f"Target app ({', '.join(VALID_APP_TYPES)})"),
+    app: str = typer.Option(..., "--app", "-a", help=f"Target app ({', '.join(VALID_APP_TYPES)}) - Note: opencode prompt = rules"),
     level: str = typer.Option("user", "--level", "-l", help="Level: user or project"),
     project_dir: Optional[Path] = typer.Option(None, "--project-dir", "-d", help="Project directory (for project level)"),
 ):
@@ -459,7 +459,7 @@ def install_prompt(
 
 @prompt_app.command("uninstall")
 def uninstall_prompt(
-    app: str = typer.Option(..., "--app", "-a", help=f"Target app ({', '.join(VALID_APP_TYPES)})"),
+    app: str = typer.Option(..., "--app", "-a", help=f"Target app ({', '.join(VALID_APP_TYPES)}) - Note: opencode prompt = rules"),
     level: str = typer.Option("user", "--level", "-l", help="Level: user or project"),
     project_dir: Optional[Path] = typer.Option(None, "--project-dir", "-d", help="Project directory (for project level)"),
     force: bool = typer.Option(False, "--force", "-f", help="Skip confirmation"),

code_assistant_manager/mcp/__init__.py

@@ -17,6 +17,7 @@
     GeminiMCPClient,
     IflowMCPClient,
     NeovateMCPClient,
+    OpenCodeMCPClient,
     QoderCLIMCPClient,
     QwenMCPClient,
     ZedMCPClient,
@@ -40,4 +41,5 @@
     "ZedMCPClient",
     "QoderCLIMCPClient",
     "NeovateMCPClient",
+    "OpenCodeMCPClient",
 ]

code_assistant_manager/mcp/clients.py

@@ -10,6 +10,7 @@
 from .gemini import GeminiMCPClient
 from .iflow import IflowMCPClient
 from .neovate import NeovateMCPClient
+from .opencode import OpenCodeMCPClient
 from .qodercli import QoderCLIMCPClient
 from .qwen import QwenMCPClient
 from .zed import ZedMCPClient
@@ -25,6 +26,7 @@
     "GeminiMCPClient",
     "IflowMCPClient",
     "NeovateMCPClient",
+    "OpenCodeMCPClient",
     "QoderCLIMCPClient",
     "QwenMCPClient",
     "ZedMCPClient",

code_assistant_manager/mcp/manager.py

@@ -29,6 +29,7 @@ def _initialize_clients(
             GeminiMCPClient,
             IflowMCPClient,
             NeovateMCPClient,
+            OpenCodeMCPClient,
             QoderCLIMCPClient,
             QwenMCPClient,
             ZedMCPClient,
@@ -48,6 +49,7 @@ def _initialize_clients(
             "neovate": NeovateMCPClient(),
             "crush": CrushMCPClient(),
             "cursor-agent": CursorAgentMCPClient(),
+            "opencode": OpenCodeMCPClient(),
         }
 
     def get_client(self, tool_name: str):