claude-mpm 5.4.22__py3-none-any.whl → 5.6.34__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/profile_parser.py

@@ -0,0 +1,147 @@
+"""
+Profile command parser for claude-mpm CLI.
+
+WHY: This module provides the profile command for managing deployment profiles
+that control which agents and skills are deployed.
+
+DESIGN DECISION: Provides intuitive subcommands for listing, activating,
+and inspecting profiles to reduce context usage by limiting deployed components.
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_profile_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the profile subparser for deployment profile management.
+
+    WHY: Users need to manage which agents and skills are deployed to reduce
+    context usage and improve performance. Profiles define enabled/disabled
+    agents and skills for specific workflows.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured profile subparser
+    """
+    # Profile command with subcommands
+    profile_parser = subparsers.add_parser(
+        "profile",
+        help="Manage deployment profiles for agents and skills",
+        description="""
+Deployment profile management for Claude MPM.
+
+Profiles control which agents and skills are deployed, reducing context usage
+by limiting available agents to only what's needed for your workflow.
+
+Available commands:
+  list      List all available profiles
+  set       Set the active profile
+  status    Show current active profile and filtering summary
+  show      Show detailed configuration of a profile
+
+Example workflows:
+  # List available profiles
+  claude-mpm profile list
+
+  # Activate a profile
+  claude-mpm profile set framework-development
+
+  # Check current profile status
+  claude-mpm profile status
+
+  # View profile details
+  claude-mpm profile show framework-development
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(profile_parser)
+
+    # Add subcommands
+    profile_subparsers = profile_parser.add_subparsers(
+        dest="profile_command",
+        help="Profile management commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # List subcommand
+    list_parser = profile_subparsers.add_parser(
+        "list",
+        help="List all available deployment profiles",
+        description="""
+List all profiles found in .claude-mpm/profiles/ directory.
+
+Shows profile names, descriptions, and indicates which profile is currently active.
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(list_parser)
+
+    # Set subcommand
+    set_parser = profile_subparsers.add_parser(
+        "set",
+        help="Set the active deployment profile",
+        description="""
+Set the active deployment profile.
+
+This updates configuration.yaml with the selected profile, which will be
+applied on next startup or when running 'claude-mpm init'.
+
+Examples:
+  # Activate framework development profile
+  claude-mpm profile set framework-development
+
+  # Activate minimal profile for focused work
+  claude-mpm profile set minimal
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(set_parser)
+    set_parser.add_argument(
+        "profile_name",
+        help="Name of profile to activate (without .yaml extension)",
+    )
+
+    # Status subcommand
+    status_parser = profile_subparsers.add_parser(
+        "status",
+        help="Show current active profile and filtering summary",
+        description="""
+Display current active profile with filtering summary.
+
+Shows:
+- Active profile name
+- Number of agents enabled/disabled
+- Number of skills enabled/disabled
+- Disabled skill patterns
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(status_parser)
+
+    # Show subcommand
+    show_parser = profile_subparsers.add_parser(
+        "show",
+        help="Show detailed configuration of a profile",
+        description="""
+Display detailed configuration of a specific profile.
+
+Shows complete lists of enabled/disabled agents and skills, including
+glob patterns for skill filtering.
+
+Examples:
+  # Show framework development profile details
+  claude-mpm profile show framework-development
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(show_parser)
+    show_parser.add_argument(
+        "profile_name",
+        help="Name of profile to display (without .yaml extension)",
+    )
+
+    return profile_parser

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