feat: add multi-source repository configuration support

Implement flexible multi-source repository configuration system inspired by awesome-claude-skills:

Features:
- Load repos from multiple sources in priority order:
  1. Local files (~/.config/code-assistant-manager/*.json) - highest priority
  2. Remote URLs (with HTTP caching) - community repos
  3. Bundled defaults - package fallback

- config.yaml configuration:
  * Define local and remote sources for skills/agents/plugins
  * Configure cache TTL and directory
  * Add custom remote sources easily

- RepoConfigLoader utility:
  * HTTP fetcher for remote sources
  * Local caching with configurable TTL (default: 1 hour)
  * Smart merging with priority handling
  * Offline support via cache and bundled fallbacks

- Updated all managers:
  * skills/manager.py - multi-source skill repos
  * agents/manager.py - multi-source agent repos
  * plugins/manager.py - multi-source plugin repos

Benefits:
- ✓ Automatic community updates from remote sources
- ✓ Custom local overrides without conflicts
- ✓ Offline development with local/bundled fallbacks
- ✓ Cached remote sources reduce network requests
- ✓ Fully backward compatible

Testing:
- Successfully loads 25 skill repos (remote + bundled)
- Successfully loads 9 agent repos (remote + bundled)
- Successfully loads 26 plugin repos (remote + bundled)
- All existing tests pass
- No breaking changes

Files:
- Created: config.yaml, repo_loader.py, docs/multi-source-repos.md
- Modified: skills/manager.py, agents/manager.py, plugins/manager.py

Author: James Zhu

code_assistant_manager/agents/manager.py

@@ -10,6 +10,7 @@
 from pathlib import Path
 from typing import Dict, List, Optional, Type
 
+from ..repo_loader import RepoConfigLoader
 from .base import BaseAgentHandler
 from .claude import ClaudeAgentHandler
 from .codebuddy import CodebuddyAgentHandler
@@ -24,41 +25,63 @@
 logger = logging.getLogger(__name__)
 
 
-def _load_builtin_agent_repos() -> List[Dict]:
-    """Load built-in agent repos from the bundled agent_repos.json file."""
+def _load_builtin_agent_repos() -> Dict:
+    """Load built-in agent repos from the bundled agent_repos.json file.
+
+    Returns bundled repos as a dictionary for fallback.
+    """
     package_dir = Path(__file__).parent.parent
     repos_file = package_dir / "agent_repos.json"
 
     if repos_file.exists():
         try:
             with open(repos_file, "r", encoding="utf-8") as f:
                 repos_data = json.load(f)
-                return [
-                    {
-                        "owner": repo.get("owner"),
-                        "name": repo.get("name"),
-                        "branch": repo.get("branch", "main"),
-                        "enabled": repo.get("enabled", True),
-                        "agentsPath": repo.get("agentsPath"),
-                    }
-                    for repo in repos_data.values()
-                ]
+                return repos_data
         except Exception as e:
             logger.warning(f"Failed to load builtin agent repos: {e}")
 
     # Fallback defaults
-    return [
-        {
+    return {
+        "iannuttall/claude-agents": {
             "owner": "iannuttall",
             "name": "claude-agents",
             "branch": "main",
             "enabled": True,
             "agentsPath": "agents",
         },
+    }
+
+
+def _load_agent_repos_from_config(config_dir: Optional[Path] = None) -> List[Dict]:
+    """Load agent repos from config.yaml sources.
+
+    Args:
+        config_dir: Configuration directory
+
+    Returns:
+        List of repository configurations
+    """
+    loader = RepoConfigLoader(config_dir)
+    bundled_fallback = _load_builtin_agent_repos()
+
+    # Get repos from all configured sources
+    repos_dict = loader.get_repos("agents", bundled_fallback)
+
+    # Convert to list format for backward compatibility
+    return [
+        {
+            "owner": repo.get("owner"),
+            "name": repo.get("name"),
+            "branch": repo.get("branch", "main"),
+            "enabled": repo.get("enabled", True),
+            "agentsPath": repo.get("agentsPath"),
+        }
+        for repo in repos_dict.values()
     ]
 
 
-DEFAULT_AGENT_REPOS = _load_builtin_agent_repos()
+DEFAULT_AGENT_REPOS = _load_agent_repos_from_config()
 
 # Registry of available handlers
 AGENT_HANDLERS: Dict[str, Type[BaseAgentHandler]] = {

code_assistant_manager/config.yaml

@@ -0,0 +1,42 @@
+# Code Assistant Manager - Repository Configuration
+# This file configures sources for skills, agents, and plugins
+
+repositories:
+  # Skill repositories
+  skills:
+    sources:
+      # Local user file (highest priority)
+      - type: local
+        path: ~/.config/code-assistant-manager/skill_repos.json
+      
+      # Remote awesome repository configs
+      - type: remote
+        url: https://raw.githubusercontent.com/Chat2AnyLLM/awesome-repo-configs/main/skill_repos.json
+  
+  # Agent repositories
+  agents:
+    sources:
+      # Local user file (highest priority)
+      - type: local
+        path: ~/.config/code-assistant-manager/agent_repos.json
+      
+      # Remote awesome repository configs
+      - type: remote
+        url: https://raw.githubusercontent.com/Chat2AnyLLM/awesome-repo-configs/main/agent_repos.json
+  
+  # Plugin repositories
+  plugins:
+    sources:
+      # Local user file (highest priority)
+      - type: local
+        path: ~/.config/code-assistant-manager/plugin_repos.json
+      
+      # Remote awesome repository configs
+      - type: remote
+        url: https://raw.githubusercontent.com/Chat2AnyLLM/awesome-repo-configs/main/plugin_repos.json
+
+# Cache settings for remote sources
+cache:
+  enabled: true
+  directory: ~/.cache/code-assistant-manager/repos
+  ttl_seconds: 3600  # Cache remote sources for 1 hour

code_assistant_manager/plugins/manager.py

@@ -5,6 +5,7 @@
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Type
 
+from ..repo_loader import RepoConfigLoader
 from .base import BasePluginHandler
 from .claude import ClaudePluginHandler
 from .codebuddy import CodebuddyPluginHandler
@@ -16,7 +17,10 @@
 
 
 def _load_builtin_plugin_repos() -> Dict[str, PluginRepo]:
-    """Load built-in plugin repos from the bundled plugin_repos.json file."""
+    """Load built-in plugin repos from the bundled plugin_repos.json file.
+
+    Returns bundled repos as PluginRepo objects for fallback.
+    """
     package_dir = Path(__file__).parent.parent
     repos_file = package_dir / "plugin_repos.json"
 
@@ -44,6 +48,54 @@ def _load_builtin_plugin_repos() -> Dict[str, PluginRepo]:
     return repos
 
 
+def _load_plugin_repos_from_config(config_dir: Optional[Path] = None) -> Dict[str, PluginRepo]:
+    """Load plugin repos from config.yaml sources.
+
+    Args:
+        config_dir: Configuration directory
+
+    Returns:
+        Dictionary of PluginRepo objects
+    """
+    loader = RepoConfigLoader(config_dir)
+    bundled_fallback_dict = _load_builtin_plugin_repos()
+
+    # Convert PluginRepo objects to dict for loader
+    bundled_data = {}
+    for key, repo in bundled_fallback_dict.items():
+        bundled_data[key] = {
+            "name": repo.name,
+            "description": repo.description,
+            "repoOwner": repo.repo_owner,
+            "repoName": repo.repo_name,
+            "repoBranch": repo.repo_branch,
+            "pluginPath": repo.plugin_path,
+            "enabled": repo.enabled,
+            "type": repo.type,
+            "aliases": repo.aliases,
+        }
+
+    # Get repos from all configured sources
+    repos_dict = loader.get_repos("plugins", bundled_data)
+
+    # Convert back to PluginRepo objects
+    repos: Dict[str, PluginRepo] = {}
+    for key, repo_data in repos_dict.items():
+        repos[key] = PluginRepo(
+            name=repo_data.get("name", key),
+            description=repo_data.get("description", ""),
+            repo_owner=repo_data.get("repoOwner"),
+            repo_name=repo_data.get("repoName"),
+            repo_branch=repo_data.get("repoBranch", "main"),
+            plugin_path=repo_data.get("pluginPath"),
+            enabled=repo_data.get("enabled", True),
+            type=repo_data.get("type", "plugin"),
+            aliases=repo_data.get("aliases", []),
+        )
+
+    return repos
+
+
 # Registry of all available plugin handlers
 PLUGIN_HANDLERS: Dict[str, Type[BasePluginHandler]] = {
     "claude": ClaudePluginHandler,
@@ -56,7 +108,7 @@ def _load_builtin_plugin_repos() -> Dict[str, PluginRepo]:
 VALID_APP_TYPES = list(PLUGIN_HANDLERS.keys())
 
 # Built-in plugin repositories
-BUILTIN_PLUGIN_REPOS = _load_builtin_plugin_repos()
+BUILTIN_PLUGIN_REPOS = _load_plugin_repos_from_config()
 
 
 def get_handler(app_type: str) -> BasePluginHandler: