claude-mpm 5.6.1__py3-none-any.whl → 5.6.76__py3-none-any.whl

claude_mpm/cli/parsers/commander_parser.py

@@ -23,17 +23,21 @@ def add_commander_subparser(subparsers: argparse._SubParsersAction) -> None:
     """
     commander_parser = subparsers.add_parser(
         "commander",
-        help="Interactive Commander mode for managing multiple Claude instances",
+        help="Launch Commander multi-project orchestration (ALPHA)",
         description="""
-Commander Mode - Interactive Instance Management
+Commander Mode - Multi-Project Orchestration (ALPHA)
 
-Commander provides an interactive REPL interface for:
-- Starting and stopping Claude Code/MPM instances in tmux
-- Connecting to instances and sending natural language commands
-- Managing multiple concurrent projects
-- Viewing instance status and output
+The commander subcommand auto-starts the Commander daemon (if not already running)
+and launches an interactive REPL for managing multiple Claude Code instances.
 
-Commands:
+Commander provides:
+- Auto-starting daemon that manages project lifecycles
+- Interactive REPL for controlling instances
+- Tmux-based session management
+- Real-time output monitoring
+- REST API for external control (http://127.0.0.1:8765)
+
+REPL Commands:
   list, ls, instances   List active instances
   start <path>          Start new instance at path
     --framework <cc|mpm>  Specify framework (default: cc)
@@ -50,7 +54,16 @@ Natural Language:
   command will be sent to the connected instance as a message.
 
 Examples:
+  # Start daemon and launch interactive chat
   claude-mpm commander
+
+  # Start daemon only (no chat interface)
+  claude-mpm commander --daemon-only
+
+  # Use custom port
+  claude-mpm commander --port 9000
+
+  # In REPL:
   > start ~/myproject --framework cc --name myapp
   > connect myapp
   > Fix the authentication bug in login.py
@@ -64,8 +77,8 @@ Examples:
     commander_parser.add_argument(
         "--port",
         type=int,
-        default=8765,
-        help="Port for internal services (default: 8765)",
+        default=8766,  # NetworkPorts.COMMANDER_DEFAULT
+        help="Port for internal services (default: 8766)",
     )
 
     # Optional: State directory
@@ -81,3 +94,23 @@ Examples:
         action="store_true",
         help="Enable debug logging",
     )
+
+    # Daemon auto-start options
+    commander_parser.add_argument(
+        "--host",
+        type=str,
+        default="127.0.0.1",
+        help="Daemon host (default: 127.0.0.1)",
+    )
+
+    commander_parser.add_argument(
+        "--no-chat",
+        action="store_true",
+        help="Start daemon only without interactive chat",
+    )
+
+    commander_parser.add_argument(
+        "--daemon-only",
+        action="store_true",
+        help="Alias for --no-chat (start daemon only)",
+    )

claude_mpm/cli/parsers/mcp_parser.py

@@ -192,4 +192,83 @@ def add_mcp_subparser(subparsers) -> argparse.ArgumentParser:
         "--force", action="store_true", help="Force overwrite existing configuration"
     )
 
+    # =========================================================================
+    # Service Management Commands (enable/disable/list)
+    # =========================================================================
+
+    # Enable MCP service
+    enable_parser = mcp_subparsers.add_parser(
+        MCPCommands.ENABLE.value,
+        help="Enable an MCP service in configuration",
+    )
+    enable_parser.add_argument(
+        "service_name",
+        help="Name of the MCP service to enable (e.g., kuzu-memory, mcp-github)",
+    )
+    enable_parser.add_argument(
+        "--interactive",
+        "-i",
+        action="store_true",
+        help="Prompt for required credentials interactively",
+    )
+    enable_parser.add_argument(
+        "--env",
+        "-e",
+        action="append",
+        metavar="KEY=VALUE",
+        help="Set environment variable (can be used multiple times)",
+    )
+    enable_parser.add_argument(
+        "--global",
+        dest="use_global",
+        action="store_true",
+        help="Enable in global ~/.claude.json instead of project .mcp.json",
+    )
+
+    # Disable MCP service
+    disable_parser = mcp_subparsers.add_parser(
+        MCPCommands.DISABLE.value,
+        help="Disable an MCP service from configuration",
+    )
+    disable_parser.add_argument(
+        "service_name",
+        help="Name of the MCP service to disable",
+    )
+    disable_parser.add_argument(
+        "--global",
+        dest="use_global",
+        action="store_true",
+        help="Disable in global ~/.claude.json instead of project .mcp.json",
+    )
+
+    # List MCP services
+    list_parser = mcp_subparsers.add_parser(
+        MCPCommands.LIST.value,
+        help="List MCP services (available and enabled)",
+    )
+    list_parser.add_argument(
+        "--available",
+        "-a",
+        action="store_true",
+        help="Show all available services from registry",
+    )
+    list_parser.add_argument(
+        "--enabled",
+        "-e",
+        action="store_true",
+        help="Show only enabled services",
+    )
+    list_parser.add_argument(
+        "--global",
+        dest="use_global",
+        action="store_true",
+        help="Check global ~/.claude.json instead of project .mcp.json",
+    )
+    list_parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed service information",
+    )
+
     return mcp_parser

claude_mpm/cli/parsers/oauth_parser.py

@@ -0,0 +1,165 @@
+"""
+OAuth command parser for claude-mpm CLI.
+
+WHY: This module provides the oauth command with subcommands for
+managing OAuth authentication for MCP services that require OAuth2 flows.
+
+DESIGN DECISION: 'oauth' provides comprehensive OAuth management including
+listing OAuth-capable services, setup, status, token revocation, and refresh.
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_oauth_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the oauth subparser with all OAuth management subcommands.
+
+    WHY: 'oauth' provides comprehensive OAuth management for MCP services
+    that require OAuth2 authentication flows.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured oauth subparser
+    """
+    # OAuth command with subcommands
+    oauth_parser = subparsers.add_parser(
+        "oauth",
+        help="Manage OAuth authentication for MCP services",
+        description="""
+Manage OAuth authentication for MCP services.
+
+Available commands:
+  list              List OAuth-capable MCP services
+  setup <service>   Set up OAuth authentication for a service
+  status <service>  Show OAuth token status for a service
+  revoke <service>  Revoke OAuth tokens for a service
+  refresh <service> Refresh OAuth tokens for a service
+
+Examples:
+  claude-mpm oauth list
+  claude-mpm oauth setup workspace-mcp
+  claude-mpm oauth status workspace-mcp
+  claude-mpm oauth revoke workspace-mcp
+  claude-mpm oauth refresh workspace-mcp
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(oauth_parser)
+
+    # Add subcommands
+    oauth_subparsers = oauth_parser.add_subparsers(
+        dest="oauth_command", help="OAuth commands", metavar="SUBCOMMAND"
+    )
+
+    # List subcommand
+    list_parser = oauth_subparsers.add_parser(
+        "list",
+        help="List OAuth-capable MCP services",
+        description="List all MCP services that support OAuth authentication.",
+    )
+    add_common_arguments(list_parser)
+    list_parser.add_argument(
+        "--format",
+        choices=["table", "json"],
+        default="table",
+        help="Output format (default: table)",
+    )
+
+    # Setup subcommand
+    setup_parser = oauth_subparsers.add_parser(
+        "setup",
+        help="Set up OAuth authentication for a service",
+        description="""
+Set up OAuth authentication for an MCP service.
+
+This command initiates the OAuth2 flow by:
+1. Looking for credentials in .env.local, .env, or environment variables
+2. Prompting for credentials if not found
+3. Opening a browser for user authentication
+4. Starting a local callback server to receive the OAuth redirect
+5. Storing the tokens securely for future use
+
+Required environment variables (checked in order):
+  1. .env.local file (highest priority)
+  2. .env file
+  3. Environment variables
+
+For Google OAuth services:
+  GOOGLE_OAUTH_CLIENT_ID     - Your OAuth client ID
+  GOOGLE_OAUTH_CLIENT_SECRET - Your OAuth client secret
+
+Get credentials from: https://console.cloud.google.com/apis/credentials
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(setup_parser)
+    setup_parser.add_argument(
+        "service_name",
+        help="Name of the MCP service to authenticate (e.g., workspace-mcp)",
+    )
+    setup_parser.add_argument(
+        "--no-browser",
+        action="store_true",
+        help="Don't open browser automatically, just print the URL",
+    )
+    setup_parser.add_argument(
+        "--port",
+        type=int,
+        default=8085,
+        help="Port for the OAuth callback server (default: 8085)",
+    )
+
+    # Status subcommand
+    status_parser = oauth_subparsers.add_parser(
+        "status",
+        help="Show OAuth token status for a service",
+        description="Display the current OAuth token status including validity and expiration.",
+    )
+    add_common_arguments(status_parser)
+    status_parser.add_argument(
+        "service_name",
+        help="Name of the MCP service to check",
+    )
+    status_parser.add_argument(
+        "--format",
+        choices=["table", "json"],
+        default="table",
+        help="Output format (default: table)",
+    )
+
+    # Revoke subcommand
+    revoke_parser = oauth_subparsers.add_parser(
+        "revoke",
+        help="Revoke OAuth tokens for a service",
+        description="Revoke and delete stored OAuth tokens for a service.",
+    )
+    add_common_arguments(revoke_parser)
+    revoke_parser.add_argument(
+        "service_name",
+        help="Name of the MCP service to revoke tokens for",
+    )
+    revoke_parser.add_argument(
+        "-y",
+        "--yes",
+        action="store_true",
+        help="Skip confirmation prompt",
+    )
+
+    # Refresh subcommand
+    refresh_parser = oauth_subparsers.add_parser(
+        "refresh",
+        help="Refresh OAuth tokens for a service",
+        description="Refresh the OAuth tokens using the stored refresh token.",
+    )
+    add_common_arguments(refresh_parser)
+    refresh_parser.add_argument(
+        "service_name",
+        help="Name of the MCP service to refresh tokens for",
+    )
+
+    return oauth_parser

claude_mpm/cli/parsers/skill_source_parser.py

@@ -76,6 +76,10 @@ def add_skill_source_subparser(subparsers) -> argparse.ArgumentParser:
         dest="skip_test",
         help="Skip immediate testing (not recommended)",
     )
+    add_parser.add_argument(
+        "--token",
+        help="GitHub token or env var reference (e.g., ghp_xxx or $PRIVATE_TOKEN)",
+    )
 
     # Remove repository
     remove_parser = skill_source_subparsers.add_parser(

claude_mpm/cli/parsers/skills_parser.py

@@ -167,6 +167,11 @@ def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
         action="store_true",
         help="Force redeployment of already deployed skills",
     )
+    deploy_github_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Deploy all available skills, not just agent-referenced ones",
+    )
 
     # List available GitHub skills
     list_available_parser = skills_subparsers.add_parser(