claude-mpm 5.4.41__py3-none-any.whl → 5.6.72__py3-none-any.whl

claude_mpm/cli/parsers/commander_parser.py

@@ -0,0 +1,116 @@
+"""
+Commander parser module for claude-mpm CLI.
+
+WHY: This module provides the commander subcommand for interactive instance management
+and chat interface.
+
+DESIGN DECISION: Uses subparser pattern consistent with other commands (run, agents, etc.)
+to provide a clean interface for Commander mode.
+"""
+
+import argparse
+from pathlib import Path
+
+
+def add_commander_subparser(subparsers: argparse._SubParsersAction) -> None:
+    """
+    Add commander subcommand parser.
+
+    WHY: Provides interactive mode for managing and chatting with multiple Claude instances.
+
+    Args:
+        subparsers: The subparsers object to add the commander parser to
+    """
+    commander_parser = subparsers.add_parser(
+        "commander",
+        help="Launch Commander multi-project orchestration (ALPHA)",
+        description="""
+Commander Mode - Multi-Project Orchestration (ALPHA)
+
+The commander subcommand auto-starts the Commander daemon (if not already running)
+and launches an interactive REPL for managing multiple Claude Code instances.
+
+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)
+    --name <name>         Specify instance name (default: dir name)
+  stop <name>           Stop an instance
+  connect <name>        Connect to an instance
+  disconnect            Disconnect from current instance
+  status                Show current session status
+  help                  Show help message
+  exit, quit, q         Exit Commander
+
+Natural Language:
+  When connected to an instance, any input that is not a built-in
+  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
+  > disconnect
+  > exit
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+
+    # Optional: Port for internal services
+    commander_parser.add_argument(
+        "--port",
+        type=int,
+        default=8766,  # NetworkPorts.COMMANDER_DEFAULT
+        help="Port for internal services (default: 8766)",
+    )
+
+    # Optional: State directory
+    commander_parser.add_argument(
+        "--state-dir",
+        type=Path,
+        help="Directory for state persistence (optional)",
+    )
+
+    # Debug mode
+    commander_parser.add_argument(
+        "--debug",
+        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/profile_parser.py

@@ -10,7 +10,6 @@ and inspecting profiles to reduce context usage by limiting deployed components.
 
 import argparse
 
-from ...constants import CLICommands
 from .base_parser import add_common_arguments
 
 

claude_mpm/cli/parsers/run_parser.py

@@ -85,6 +85,16 @@ def add_run_arguments(parser: argparse.ArgumentParser) -> None:
         action="store_true",
         help="Pass --resume flag to Claude Code to resume the last conversation",
     )
+    run_group.add_argument(
+        "--chrome",
+        action="store_true",
+        help="Enable Claude in Chrome integration (passed to Claude Code)",
+    )
+    run_group.add_argument(
+        "--no-chrome",
+        action="store_true",
+        help="Disable Claude in Chrome integration (passed to Claude Code)",
+    )
 
     # Dependency checking options
     dep_group = parser.add_argument_group("dependency options")

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

@@ -168,10 +168,9 @@ def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
         help="Force redeployment of already deployed skills",
     )
     deploy_github_parser.add_argument(
-        "--all-skills",
+        "--all",
         action="store_true",
-        dest="all_skills",
-        help="Deploy ALL available skills (not just agent-referenced). By default, only skills referenced in agent frontmatter are deployed.",
+        help="Deploy all available skills, not just agent-referenced ones",
     )
 
     # List available GitHub skills