diff --git a/docs/cli-reference.md b/docs/cli-reference.md index 60a96e852..5258d65d0 100644 --- a/docs/cli-reference.md +++ b/docs/cli-reference.md @@ -109,7 +109,7 @@ apm init my-project --yes Install APM package and MCP server dependencies from `apm.yml` (like `npm install`). Auto-creates minimal `apm.yml` when packages are specified but no manifest exists. ```bash -apm install [PACKAGES...] [OPTIONS] +apm install [OPTIONS] [PACKAGES...] ``` **Arguments:** @@ -120,11 +120,11 @@ apm install [PACKAGES...] [OPTIONS] - `--exclude TEXT` - Exclude specific runtime from installation - `--only [apm|mcp]` - Install only specific dependency type - `--update` - Update dependencies to latest Git references -- `--force` - Overwrite locally-authored files on collision - `--dry-run` - Show what would be installed without installing -- `--parallel-downloads INT` - Max concurrent package downloads (default: 4, 0 to disable) +- `--force` - Overwrite locally-authored files on collision - `--verbose` - Show detailed installation information - `--trust-transitive-mcp` - Trust self-defined MCP servers from transitive packages (skip re-declaration requirement) +- `--parallel-downloads INT` - Max concurrent package downloads (default: 4, 0 to disable) **Behavior:** - `apm install` (no args): Installs **all** packages from `apm.yml` @@ -548,11 +548,11 @@ company-website (local) Display comprehensive information about a specific installed package. ```bash -apm deps info PACKAGE_NAME +apm deps info PACKAGE ``` **Arguments:** -- `PACKAGE_NAME` - Name of the package to show information about +- `PACKAGE` - Name of the package to show information about **Examples:** ```bash @@ -595,11 +595,11 @@ apm deps clean Update installed APM dependencies to their latest versions. ```bash -apm deps update [PACKAGE_NAME] +apm deps update [PACKAGE] ``` **Arguments:** -- `PACKAGE_NAME` - Optional. Update specific package only +- `PACKAGE` - Optional. Update specific package only **Examples:** ```bash @@ -627,7 +627,7 @@ apm mcp list [OPTIONS] ``` **Options:** -- `--limit INTEGER` - Number of results to show +- `--limit INTEGER` - Number of results to show (default: 20) **Examples:** ```bash @@ -1087,7 +1087,7 @@ apm runtime remove RUNTIME_NAME **Options:** - `--yes` - Confirm the action without prompting -#### `apm runtime status` - Show runtime status +#### `apm runtime status` - Check which runtime will be used Display which runtime APM will use for execution and runtime preference order. diff --git a/src/apm_cli/commands/config.py b/src/apm_cli/commands/config.py index a9769e02d..90fff9a4b 100644 --- a/src/apm_cli/commands/config.py +++ b/src/apm_cli/commands/config.py @@ -27,7 +27,7 @@ def config(ctx): console = _get_console() # Create configuration display config_table = Table( - title="āš™ļø Current APM Configuration", + title="Current APM Configuration", show_header=True, header_style="bold cyan", ) diff --git a/src/apm_cli/commands/deps.py b/src/apm_cli/commands/deps.py index 4a1d4627e..ca102fe6c 100644 --- a/src/apm_cli/commands/deps.py +++ b/src/apm_cli/commands/deps.py @@ -44,10 +44,10 @@ def list_packages(): # Check if apm_modules exists if not apm_modules_path.exists(): if has_rich: - console.print("šŸ’” No APM dependencies installed yet", style="cyan") + console.print("No APM dependencies installed yet", style="cyan") console.print("Run 'apm install' to install dependencies from apm.yml", style="dim") else: - click.echo("šŸ’” No APM dependencies installed yet") + click.echo("No APM dependencies installed yet") click.echo("Run 'apm install' to install dependencies from apm.yml") return @@ -157,18 +157,18 @@ def list_packages(): 'is_orphaned': is_orphaned }) except Exception as e: - click.echo(f"āš ļø Warning: Failed to read package {org_repo_name}: {e}") + click.echo(f"Warning: Failed to read package {org_repo_name}: {e}") if not installed_packages: if has_rich: - console.print("šŸ’” apm_modules/ directory exists but contains no valid packages", style="cyan") + console.print("apm_modules/ directory exists but contains no valid packages", style="cyan") else: - click.echo("šŸ’” apm_modules/ directory exists but contains no valid packages") + click.echo("apm_modules/ directory exists but contains no valid packages") return # Display packages in table format if has_rich: - table = Table(title="šŸ“‹ APM Dependencies", show_header=True, header_style="bold cyan") + table = Table(title="APM Dependencies", show_header=True, header_style="bold cyan") table.add_column("Package", style="bold white") table.add_column("Version", style="yellow") table.add_column("Source", style="blue") @@ -195,13 +195,13 @@ def list_packages(): # Show orphaned packages warning if orphaned_packages: - console.print(f"\nāš ļø {len(orphaned_packages)} orphaned package(s) found (not in apm.yml):", style="yellow") + console.print(f"\n{len(orphaned_packages)} orphaned package(s) found (not in apm.yml):", style="yellow") for pkg in orphaned_packages: console.print(f" ā€¢ {pkg}", style="dim yellow") - console.print("\nšŸ’” Run 'apm prune' to remove orphaned packages", style="cyan") + console.print("\nRun 'apm prune' to remove orphaned packages", style="cyan") else: # Fallback text table - click.echo("šŸ“‹ APM Dependencies:") + click.echo("APM Dependencies:") click.echo(f"{'Package':<30} {'Version':<10} {'Source':<12} {'Prompts':>7} {'Instr':>7} {'Agents':>7} {'Skills':>7} {'Hooks':>7}") click.echo("-" * 98) @@ -219,10 +219,10 @@ def list_packages(): # Show orphaned packages warning if orphaned_packages: - click.echo(f"\nāš ļø {len(orphaned_packages)} orphaned package(s) found (not in apm.yml):") + click.echo(f"\n{len(orphaned_packages)} orphaned package(s) found (not in apm.yml):") for pkg in orphaned_packages: click.echo(f" ā€¢ {pkg}") - click.echo("\nšŸ’” Run 'apm prune' to remove orphaned packages") + click.echo("\nRun 'apm prune' to remove orphaned packages") except Exception as e: _rich_error(f"Error listing dependencies: {e}") diff --git a/src/apm_cli/commands/install.py b/src/apm_cli/commands/install.py index 217b274f0..cf3eec480 100644 --- a/src/apm_cli/commands/install.py +++ b/src/apm_cli/commands/install.py @@ -287,7 +287,7 @@ def _validate_package_exists(package): "--dry-run", is_flag=True, help="Show what would be installed without installing" ) @click.option("--force", is_flag=True, help="Overwrite locally-authored files on collision") -@click.option("--verbose", is_flag=True, help="Show detailed installation information") +@click.option("-v", "--verbose", is_flag=True, help="Show detailed installation information") @click.option( "--trust-transitive-mcp", is_flag=True, diff --git a/src/apm_cli/commands/mcp.py b/src/apm_cli/commands/mcp.py index 19d11e946..ae0517a3d 100644 --- a/src/apm_cli/commands/mcp.py +++ b/src/apm_cli/commands/mcp.py @@ -20,7 +20,7 @@ def mcp(): @mcp.command(help="Search MCP servers in registry") @click.argument("query", required=True) -@click.option("--limit", default=10, help="Number of results to show") +@click.option("--limit", default=10, show_default=True, help="Number of results to show") @click.pass_context def search(ctx, query, limit): """Search for MCP servers in the registry.""" @@ -288,7 +288,7 @@ def show(ctx, server_name): @mcp.command(help="List all available MCP servers") -@click.option("--limit", default=20, help="Number of results to show") +@click.option("--limit", default=20, show_default=True, help="Number of results to show") @click.pass_context def list(ctx, limit): """List all available MCP servers in the registry."""