feat: add OpenCode prompt and agent support

- Add OpenCodePromptHandler for managing AGENTS.md files
- Add OpenCodeAgentHandler for managing agents in ~/.config/opencode/agent/
- Update CLI help messages to include OpenCode support
- Add comprehensive test coverage for both features
- Update agent app type validation to include opencode
- Add OpenCode to prompt file path tests

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,
 )
 

tests/unit/test_cli_app_types.py

@@ -29,8 +29,8 @@ def test_skill_valid_app_types(self):
         assert set(SKILL_APP_TYPES) == expected
 
     def test_agent_valid_app_types(self):
-        """Test agent module supports all 6 app types."""
-        expected = {"claude", "codex", "gemini", "droid", "codebuddy", "copilot"}
+        """Test agent module supports all 7 app types."""
+        expected = {"claude", "codex", "gemini", "droid", "codebuddy", "copilot", "opencode"}
         assert set(AGENT_APP_TYPES) == expected
 
     def test_plugin_valid_app_types(self):
@@ -102,7 +102,7 @@ def test_agent_install_accepts_valid_app(self, runner):
             mock_manager.return_value = mock_instance
 
             # Should accept all valid app types
-            for app in ["claude", "codex", "gemini", "droid", "codebuddy"]:
+            for app in ["claude", "codex", "gemini", "droid", "codebuddy", "copilot", "opencode"]:
                 result = runner.invoke(agent_app, ["install", "test-agent", "-a", app])
                 # Should not fail with "Invalid value" error
                 assert "Invalid value" not in result.output

tests/unit/test_copilot_agent_handler.py

@@ -3,6 +3,7 @@
 import pytest
 
 from code_assistant_manager.agents.copilot import CopilotAgentHandler
+from code_assistant_manager.agents.opencode import OpenCodeAgentHandler
 
 
 def test_copilot_handler_properties(tmp_path):
@@ -12,6 +13,13 @@ def test_copilot_handler_properties(tmp_path):
     assert handler.agents_dir == tmp_path
 
 
+def test_opencode_handler_properties(tmp_path):
+    handler = OpenCodeAgentHandler(agents_dir_override=tmp_path)
+    assert handler.app_name == "opencode"
+    # When override supplied, agents_dir should match
+    assert handler.agents_dir == tmp_path
+
+
 def test_copilot_install_uninstall(tmp_path):
     # Create a fake agent markdown file in a temp repo layout
     repo_dir = tmp_path / "repo"
@@ -48,6 +56,43 @@ def fake_download(owner, name, branch):
     # Copilot agent profiles remain as .md files with normalized YAML frontmatter
     assert dest.name == "my-agent.md"
 
+
+def test_opencode_install_uninstall(tmp_path):
+    # Create a fake agent markdown file in a temp repo layout
+    repo_dir = tmp_path / "repo"
+    repo_dir.mkdir()
+    agent_md = repo_dir / "my-agent.md"
+    agent_md.write_text(
+        """---\nname: My Agent\ndescription: Test agent\n---\n# Agent"""
+    )
+
+    # Create an Agent-like object with required attributes
+    class DummyAgent:
+        def __init__(
+            self, filename, repo_owner, repo_name, repo_branch=None, agents_path=None
+        ):
+            self.filename = filename
+            self.repo_owner = repo_owner
+            self.repo_name = repo_name
+            self.repo_branch = repo_branch or "main"
+            self.agents_path = agents_path
+
+    # Monkeypatch BaseAgentHandler._download_repo by creating a handler with override
+    handler = OpenCodeAgentHandler(agents_dir_override=tmp_path / "agents")
+
+    # Patch _download_repo to return our repo_dir
+    def fake_download(owner, name, branch):
+        return repo_dir, branch
+
+    handler._download_repo = fake_download
+
+    dummy = DummyAgent("my-agent.md", "owner", "name")
+
+    dest = handler.install(dummy)
+    assert dest.exists()
+    # OpenCode agent profiles remain as .md files with normalized YAML frontmatter
+    assert dest.name == "my-agent.md"
+
     # Now uninstall should remove the .md file
     removed = handler.uninstall(dummy)
     assert removed is True

tests/unit/test_prompts.py

@@ -449,9 +449,11 @@ def test_prompt_file_paths(self):
         assert "claude" in PROMPT_FILE_PATHS
         assert "codex" in PROMPT_FILE_PATHS
         assert "gemini" in PROMPT_FILE_PATHS
+        assert "opencode" in PROMPT_FILE_PATHS
 
     def test_prompt_file_paths_values(self):
         """Test PROMPT_FILE_PATHS has correct file names."""
         assert PROMPT_FILE_PATHS["claude"].name == "CLAUDE.md"
         assert PROMPT_FILE_PATHS["codex"].name == "AGENTS.md"
         assert PROMPT_FILE_PATHS["gemini"].name == "GEMINI.md"
+        assert PROMPT_FILE_PATHS["opencode"].name == "AGENTS.md"