apm-cli 0.8.7__tar.gz → 0.8.9__tar.gz

{apm_cli-0.8.7/src/apm_cli.egg-info → apm_cli-0.8.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apm-cli
-Version: 0.8.7
+Version: 0.8.9
 Summary: MCP configuration tool
 Author-email: Daniel Meppiel <user@example.com>
 License: MIT License
@@ -66,7 +66,7 @@ Dynamic: license-file
 
 Think `package.json`, `requirements.txt`, or `Cargo.toml` — but for AI agent configuration.
 
-GitHub Copilot · Claude Code · Cursor · OpenCode
+GitHub Copilot · Claude Code · Cursor · OpenCode · Codex
 
 **[Documentation](https://microsoft.github.io/apm/)** · **[Quick Start](https://microsoft.github.io/apm/getting-started/quick-start/)** · **[CLI Reference](https://microsoft.github.io/apm/reference/cli-commands/)**
 

{apm_cli-0.8.7 → apm_cli-0.8.9}/README.md

@@ -4,7 +4,7 @@
 
 Think `package.json`, `requirements.txt`, or `Cargo.toml` — but for AI agent configuration.
 
-GitHub Copilot · Claude Code · Cursor · OpenCode
+GitHub Copilot · Claude Code · Cursor · OpenCode · Codex
 
 **[Documentation](https://microsoft.github.io/apm/)** · **[Quick Start](https://microsoft.github.io/apm/getting-started/quick-start/)** · **[CLI Reference](https://microsoft.github.io/apm/reference/cli-commands/)**
 

{apm_cli-0.8.7 → apm_cli-0.8.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "apm-cli"
-version = "0.8.7"
+version = "0.8.9"
 description = "MCP configuration tool"
 readme = "README.md"
 requires-python = ">=3.10"

{apm_cli-0.8.7 → apm_cli-0.8.9}/src/apm_cli/bundle/lockfile_enrichment.py

@@ -13,7 +13,8 @@ _TARGET_PREFIXES = {
     "claude": [".claude/"],
     "cursor": [".cursor/"],
     "opencode": [".opencode/"],
-    "all": [".github/", ".claude/", ".cursor/", ".opencode/"],
+    "codex": [".codex/", ".agents/"],
+    "all": [".github/", ".claude/", ".cursor/", ".opencode/", ".codex/", ".agents/"],
 }
 
 # Cross-target path equivalences for skills/ and agents/ directories.
@@ -46,6 +47,10 @@ _CROSS_TARGET_MAPS: Dict[str, Dict[str, str]] = {
         ".github/skills/": ".opencode/skills/",
         ".github/agents/": ".opencode/agents/",
     },
+    "codex": {
+        ".github/skills/": ".agents/skills/",
+        ".github/agents/": ".codex/agents/",
+    },
 }
 
 

{apm_cli-0.8.7 → apm_cli-0.8.9}/src/apm_cli/cli.py

@@ -22,6 +22,7 @@ from apm_cli.commands.deps import deps
 from apm_cli.commands.init import init
 from apm_cli.commands.install import install
 from apm_cli.commands.list_cmd import list as list_cmd
+from apm_cli.commands.marketplace import marketplace, search as marketplace_search
 from apm_cli.commands.mcp import mcp
 from apm_cli.commands.pack import pack_cmd, unpack_cmd
 from apm_cli.commands.prune import prune
@@ -69,6 +70,8 @@ cli.add_command(list_cmd, name="list")
 cli.add_command(config)
 cli.add_command(runtime)
 cli.add_command(mcp)
+cli.add_command(marketplace)
+cli.add_command(marketplace_search, name="search")
 
 
 def _configure_encoding() -> None:

{apm_cli-0.8.7 → apm_cli-0.8.9}/src/apm_cli/commands/_helpers.py

@@ -432,12 +432,13 @@ def _create_plugin_json(config):
         f.write(json.dumps(plugin_data, indent=2) + "\n")
 
 
-def _create_minimal_apm_yml(config, plugin=False):
+def _create_minimal_apm_yml(config, plugin=False, target_path=None):
     """Create minimal apm.yml file with auto-detected metadata.
 
     Args:
         config: dict with name, version, description, author keys.
         plugin: if True, include a devDependencies section.
+        target_path: explicit file path to write (defaults to cwd/apm.yml).
     """
     # Create minimal apm.yml structure
     apm_yml_data = {
@@ -455,4 +456,5 @@ def _create_minimal_apm_yml(config, plugin=False):
 
     # Write apm.yml
     from ..utils.yaml_io import dump_yaml
-    dump_yaml(apm_yml_data, APM_YML_FILENAME)
+    out_path = target_path or APM_YML_FILENAME
+    dump_yaml(apm_yml_data, out_path)

{apm_cli-0.8.7 → apm_cli-0.8.9}/src/apm_cli/commands/compile/cli.py

@@ -172,7 +172,7 @@ def _get_validation_suggestion(error_msg):
 @click.option(
     "--target",
     "-t",
-    type=click.Choice(["copilot", "vscode", "agents", "claude", "cursor", "opencode", "all"]),
+    type=click.Choice(["copilot", "vscode", "agents", "claude", "cursor", "opencode", "codex", "all"]),
     default=None,
     help="Target platform: copilot (AGENTS.md), claude (CLAUDE.md), cursor, opencode, or all. 'vscode' and 'agents' are deprecated aliases for 'copilot'. Auto-detects if not specified.",
 )

{apm_cli-0.8.7 → apm_cli-0.8.9}/src/apm_cli/commands/deps/cli.py

@@ -28,14 +28,205 @@ def deps():
     pass
 
 
+def _show_scope_deps(scope_label, apm_dir, logger, console, has_rich):
+    """Display dependencies for a single scope (Project or Global)."""
+    from ...deps.lockfile import LockFile, get_lockfile_path
+
+    apm_modules_path = apm_dir / APM_MODULES_DIR
+
+    # Check if apm_modules exists
+    if not apm_modules_path.exists():
+        logger.progress(f"No APM dependencies installed ({scope_label} scope)")
+        logger.verbose_detail("Run 'apm install' to install dependencies from apm.yml")
+        return
+
+    # Load project dependencies to check for orphaned packages
+    # GitHub: owner/repo or owner/virtual-pkg-name (2 levels)
+    # Azure DevOps: org/project/repo or org/project/virtual-pkg-name (3 levels)
+    declared_sources = {}  # dep_path -> 'github' | 'azure-devops'
+    try:
+        apm_yml_path = apm_dir / APM_YML_FILENAME
+        if apm_yml_path.exists():
+            project_package = APMPackage.from_apm_yml(apm_yml_path)
+            for dep in project_package.get_apm_dependencies():
+                # Build the expected installed package name
+                repo_parts = dep.repo_url.split('/')
+                source = 'azure-devops' if dep.is_azure_devops() else 'github'
+                is_ado = dep.is_azure_devops() and len(repo_parts) >= 3
+                is_gh = len(repo_parts) >= 2
+
+                if not dep.is_virtual:
+                    # Regular package: use full repo_url path
+                    if is_ado:
+                        declared_sources[f"{repo_parts[0]}/{repo_parts[1]}/{repo_parts[2]}"] = source
+                    elif is_gh:
+                        declared_sources[f"{repo_parts[0]}/{repo_parts[1]}"] = source
+                    continue
+
+                if dep.is_virtual_subdirectory() and dep.virtual_path:
+                    # Virtual subdirectory packages keep natural path structure.
+                    if is_ado:
+                        declared_sources[
+                            f"{repo_parts[0]}/{repo_parts[1]}/{repo_parts[2]}/{dep.virtual_path}"
+                        ] = source
+                    elif is_gh:
+                        declared_sources[
+                            f"{repo_parts[0]}/{repo_parts[1]}/{dep.virtual_path}"
+                        ] = source
+                    continue
+
+                # Virtual file/collection packages are flattened.
+                package_name = dep.get_virtual_package_name()
+                if is_ado:
+                    declared_sources[f"{repo_parts[0]}/{repo_parts[1]}/{package_name}"] = source
+                elif is_gh:
+                    declared_sources[f"{repo_parts[0]}/{package_name}"] = source
+    except Exception:
+        pass  # Continue without orphan detection if apm.yml parsing fails
+
+    # Also load lockfile deps to avoid false orphan flags on transitive deps
+    try:
+        lockfile_path = get_lockfile_path(apm_dir)
+        if lockfile_path.exists():
+            lockfile = LockFile.read(lockfile_path)
+            for dep in lockfile.dependencies.values():
+                # Lockfile keys match declared_sources format (owner/repo)
+                dep_key = dep.get_unique_key()
+                if dep_key and dep_key not in declared_sources:
+                    declared_sources[dep_key] = 'github'
+    except Exception:
+        pass  # Continue without lockfile if it can't be read
+
+    # Scan for installed packages in org-namespaced structure
+    # Walks the tree to find directories containing apm.yml or SKILL.md,
+    # handling GitHub (2-level), ADO (3-level), and subdirectory (4+ level) packages.
+    installed_packages = []
+    orphaned_packages = []
+    for candidate in apm_modules_path.rglob("*"):
+        if not candidate.is_dir() or candidate.name.startswith('.'):
+            continue
+        has_apm_yml = (candidate / APM_YML_FILENAME).exists()
+        has_skill_md = (candidate / SKILL_MD_FILENAME).exists()
+        if not has_apm_yml and not has_skill_md:
+            continue
+        rel_parts = candidate.relative_to(apm_modules_path).parts
+        if len(rel_parts) < 2:
+            continue
+        org_repo_name = "/".join(rel_parts)
+
+        # Skip sub-skills inside .apm/ directories -- they belong to the parent package
+        if '.apm' in rel_parts:
+            continue
+
+        # Skip skill sub-dirs nested inside another package (e.g. plugin
+        # skills/ directories that are deployment artifacts, not packages).
+        if has_skill_md and not has_apm_yml and _is_nested_under_package(candidate, apm_modules_path):
+            continue
+
+        try:
+            version = 'unknown'
+            if has_apm_yml:
+                package = APMPackage.from_apm_yml(candidate / APM_YML_FILENAME)
+                version = package.version or 'unknown'
+            primitives = _count_primitives(candidate)
+
+            is_orphaned = org_repo_name not in declared_sources
+            if is_orphaned:
+                orphaned_packages.append(org_repo_name)
+
+            installed_packages.append({
+                'name': org_repo_name,
+                'version': version,
+                'source': 'orphaned' if is_orphaned else declared_sources.get(org_repo_name, 'github'),
+                'primitives': primitives,
+                'path': str(candidate),
+                'is_orphaned': is_orphaned
+            })
+        except Exception as e:
+            logger.warning(f"Failed to read package {org_repo_name}: {e}")
+
+    if not installed_packages:
+        logger.progress(
+            f"apm_modules/ directory exists but contains no valid packages ({scope_label} scope)"
+        )
+        return
+
+    # Display packages in table format
+    if has_rich:
+        from rich.table import Table
+
+        table = Table(
+            title=f" APM Dependencies ({scope_label})",
+            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")
+        table.add_column("Prompts", style="magenta", justify="center")
+        table.add_column("Instructions", style="green", justify="center")
+        table.add_column("Agents", style="cyan", justify="center")
+        table.add_column("Skills", style="yellow", justify="center")
+        table.add_column("Hooks", style="red", justify="center")
+
+        for pkg in installed_packages:
+            p = pkg['primitives']
+            table.add_row(
+                pkg['name'],
+                pkg['version'],
+                pkg['source'],
+                str(p.get('prompts', 0)) if p.get('prompts', 0) > 0 else "-",
+                str(p.get('instructions', 0)) if p.get('instructions', 0) > 0 else "-",
+                str(p.get('agents', 0)) if p.get('agents', 0) > 0 else "-",
+                str(p.get('skills', 0)) if p.get('skills', 0) > 0 else "-",
+                str(p.get('hooks', 0)) if p.get('hooks', 0) > 0 else "-",
+            )
+
+        console.print(table)
+
+        # Show orphaned packages warning
+        if orphaned_packages:
+            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")
+    else:
+        # Fallback text table
+        click.echo(f" APM Dependencies ({scope_label}):")
+        click.echo(f"{'Package':<30} {'Version':<10} {'Source':<12} {'Prompts':>7} {'Instr':>7} {'Agents':>7} {'Skills':>7} {'Hooks':>7}")
+        click.echo("-" * 98)
+
+        for pkg in installed_packages:
+            p = pkg['primitives']
+            name = pkg['name'][:28]
+            version = pkg['version'][:8]
+            source = pkg['source'][:10]
+            prompts = str(p.get('prompts', 0)) if p.get('prompts', 0) > 0 else "-"
+            instructions = str(p.get('instructions', 0)) if p.get('instructions', 0) > 0 else "-"
+            agents = str(p.get('agents', 0)) if p.get('agents', 0) > 0 else "-"
+            skills = str(p.get('skills', 0)) if p.get('skills', 0) > 0 else "-"
+            hooks = str(p.get('hooks', 0)) if p.get('hooks', 0) > 0 else "-"
+            click.echo(f"{name:<30} {version:<10} {source:<12} {prompts:>7} {instructions:>7} {agents:>7} {skills:>7} {hooks:>7}")
+
+        # Show orphaned packages warning
+        if orphaned_packages:
+            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")
+
+
 @deps.command(name="list", help="List installed APM dependencies")
-def list_packages():
+@click.option("--global", "-g", "global_", is_flag=True, default=False,
+              help="List user-scope dependencies (~/.apm/) instead of project")
+@click.option("--all", "show_all", is_flag=True, default=False,
+              help="Show both project and user-scope dependencies")
+def list_packages(global_, show_all):
     """Show all installed APM dependencies with context files and agent workflows."""
     logger = CommandLogger("deps-list")
 
     try:
         # Import Rich components with fallback
-        from rich.table import Table
         from rich.console import Console
         import shutil
         term_width = shutil.get_terminal_size((120, 24)).columns
@@ -44,192 +235,29 @@ def list_packages():
     except ImportError:
         has_rich = False
         console = None
-    
+
     try:
-        project_root = Path(".")
-        apm_modules_path = project_root / APM_MODULES_DIR
-        
-        # Check if apm_modules exists
-        if not apm_modules_path.exists():
-            logger.progress("No APM dependencies installed yet")
-            logger.verbose_detail("Run 'apm install' to install dependencies from apm.yml")
-            return
-        
-        # Load project dependencies to check for orphaned packages
-        # GitHub: owner/repo or owner/virtual-pkg-name (2 levels)
-        # Azure DevOps: org/project/repo or org/project/virtual-pkg-name (3 levels)
-        declared_sources = {}  # dep_path -> 'github' | 'azure-devops'
-        try:
-            apm_yml_path = project_root / APM_YML_FILENAME
-            if apm_yml_path.exists():
-                project_package = APMPackage.from_apm_yml(apm_yml_path)
-                for dep in project_package.get_apm_dependencies():
-                    # Build the expected installed package name
-                    repo_parts = dep.repo_url.split('/')
-                    source = 'azure-devops' if dep.is_azure_devops() else 'github'
-                    is_ado = dep.is_azure_devops() and len(repo_parts) >= 3
-                    is_gh = len(repo_parts) >= 2
-
-                    if not dep.is_virtual:
-                        # Regular package: use full repo_url path
-                        if is_ado:
-                            declared_sources[f"{repo_parts[0]}/{repo_parts[1]}/{repo_parts[2]}"] = source
-                        elif is_gh:
-                            declared_sources[f"{repo_parts[0]}/{repo_parts[1]}"] = source
-                        continue
-
-                    if dep.is_virtual_subdirectory() and dep.virtual_path:
-                        # Virtual subdirectory packages keep natural path structure.
-                        if is_ado:
-                            declared_sources[
-                                f"{repo_parts[0]}/{repo_parts[1]}/{repo_parts[2]}/{dep.virtual_path}"
-                            ] = source
-                        elif is_gh:
-                            declared_sources[
-                                f"{repo_parts[0]}/{repo_parts[1]}/{dep.virtual_path}"
-                            ] = source
-                        continue
-
-                    # Virtual file/collection packages are flattened.
-                    package_name = dep.get_virtual_package_name()
-                    if is_ado:
-                        declared_sources[f"{repo_parts[0]}/{repo_parts[1]}/{package_name}"] = source
-                    elif is_gh:
-                        declared_sources[f"{repo_parts[0]}/{package_name}"] = source
-        except Exception:
-            pass  # Continue without orphan detection if apm.yml parsing fails
-        
-        # Also load lockfile deps to avoid false orphan flags on transitive deps
-        try:
-            from ...deps.lockfile import LockFile, get_lockfile_path
-            lockfile_path = get_lockfile_path(project_root)
-            if lockfile_path.exists():
-                lockfile = LockFile.read(lockfile_path)
-                for dep in lockfile.dependencies.values():
-                    # Lockfile keys match declared_sources format (owner/repo)
-                    dep_key = dep.get_unique_key()
-                    if dep_key and dep_key not in declared_sources:
-                        declared_sources[dep_key] = 'github'
-        except Exception:
-            pass  # Continue without lockfile if it can't be read
-        
-        # Scan for installed packages in org-namespaced structure
-        # Walks the tree to find directories containing apm.yml or SKILL.md,
-        # handling GitHub (2-level), ADO (3-level), and subdirectory (4+ level) packages.
-        installed_packages = []
-        orphaned_packages = []
-        for candidate in apm_modules_path.rglob("*"):
-            if not candidate.is_dir() or candidate.name.startswith('.'):
-                continue
-            has_apm_yml = (candidate / APM_YML_FILENAME).exists()
-            has_skill_md = (candidate / SKILL_MD_FILENAME).exists()
-            if not has_apm_yml and not has_skill_md:
-                continue
-            rel_parts = candidate.relative_to(apm_modules_path).parts
-            if len(rel_parts) < 2:
-                continue
-            org_repo_name = "/".join(rel_parts)
-            
-            # Skip sub-skills inside .apm/ directories  -- they belong to the parent package
-            if '.apm' in rel_parts:
-                continue
-
-            # Skip skill sub-dirs nested inside another package (e.g. plugin
-            # skills/ directories that are deployment artifacts, not packages).
-            if has_skill_md and not has_apm_yml and _is_nested_under_package(candidate, apm_modules_path):
-                continue
-
-            try:
-                version = 'unknown'
-                if has_apm_yml:
-                    package = APMPackage.from_apm_yml(candidate / APM_YML_FILENAME)
-                    version = package.version or 'unknown'
-                primitives = _count_primitives(candidate)
-                
-                is_orphaned = org_repo_name not in declared_sources
-                if is_orphaned:
-                    orphaned_packages.append(org_repo_name)
-                
-                installed_packages.append({
-                    'name': org_repo_name,
-                    'version': version, 
-                    'source': 'orphaned' if is_orphaned else declared_sources.get(org_repo_name, 'github'),
-                    'primitives': primitives,
-                    'path': str(candidate),
-                    'is_orphaned': is_orphaned
-                })
-            except Exception as e:
-                logger.warning(f"Failed to read package {org_repo_name}: {e}")
-        
-        if not installed_packages:
-            logger.progress("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.add_column("Package", style="bold white")
-            table.add_column("Version", style="yellow") 
-            table.add_column("Source", style="blue")
-            table.add_column("Prompts", style="magenta", justify="center")
-            table.add_column("Instructions", style="green", justify="center")
-            table.add_column("Agents", style="cyan", justify="center")
-            table.add_column("Skills", style="yellow", justify="center")
-            table.add_column("Hooks", style="red", justify="center")
-            
-            for pkg in installed_packages:
-                p = pkg['primitives']
-                table.add_row(
-                    pkg['name'],
-                    pkg['version'],
-                    pkg['source'],
-                    str(p.get('prompts', 0)) if p.get('prompts', 0) > 0 else "-",
-                    str(p.get('instructions', 0)) if p.get('instructions', 0) > 0 else "-",
-                    str(p.get('agents', 0)) if p.get('agents', 0) > 0 else "-",
-                    str(p.get('skills', 0)) if p.get('skills', 0) > 0 else "-",
-                    str(p.get('hooks', 0)) if p.get('hooks', 0) > 0 else "-",
-                )
-            
-            console.print(table)
-            
-            # Show orphaned packages warning
-            if orphaned_packages:
-                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")
+        from ...core.scope import InstallScope, get_apm_dir
+
+        if show_all:
+            # Show both scopes
+            _show_scope_deps("Project", get_apm_dir(InstallScope.PROJECT), logger, console, has_rich)
+            if console and has_rich:
+                console.print()  # spacing between tables
+            _show_scope_deps("Global", get_apm_dir(InstallScope.USER), logger, console, has_rich)
+        elif global_:
+            _show_scope_deps("Global", get_apm_dir(InstallScope.USER), logger, console, has_rich)
         else:
-            # Fallback text table
-            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)
-            
-            for pkg in installed_packages:
-                p = pkg['primitives']
-                name = pkg['name'][:28]
-                version = pkg['version'][:8]
-                source = pkg['source'][:10]
-                prompts = str(p.get('prompts', 0)) if p.get('prompts', 0) > 0 else "-"
-                instructions = str(p.get('instructions', 0)) if p.get('instructions', 0) > 0 else "-"
-                agents = str(p.get('agents', 0)) if p.get('agents', 0) > 0 else "-"
-                skills = str(p.get('skills', 0)) if p.get('skills', 0) > 0 else "-"
-                hooks = str(p.get('hooks', 0)) if p.get('hooks', 0) > 0 else "-"
-                click.echo(f"{name:<30} {version:<10} {source:<12} {prompts:>7} {instructions:>7} {agents:>7} {skills:>7} {hooks:>7}")
-            
-            # Show orphaned packages warning
-            if orphaned_packages:
-                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")
-
+            _show_scope_deps("Project", get_apm_dir(InstallScope.PROJECT), logger, console, has_rich)
     except Exception as e:
         logger.error(f"Error listing dependencies: {e}")
         sys.exit(1)
 
 
-@deps.command(help="Show dependency tree structure")  
-def tree():
+@deps.command(help="Show dependency tree structure")
+@click.option("--global", "-g", "global_", is_flag=True, default=False,
+              help="Show user-scope dependency tree (~/.apm/)")
+def tree(global_):
     """Display dependencies in hierarchical tree format using lockfile."""
     logger = CommandLogger("deps-tree")
 
@@ -242,26 +270,29 @@ def tree():
     except ImportError:
         has_rich = False
         console = None
-    
+
     try:
-        project_root = Path(".")
-        apm_modules_path = project_root / APM_MODULES_DIR
-        
+        from ...core.scope import InstallScope, get_apm_dir
+        scope = InstallScope.USER if global_ else InstallScope.PROJECT
+        apm_dir = get_apm_dir(scope)
+        project_root = apm_dir
+        apm_modules_path = apm_dir / APM_MODULES_DIR
+
         # Load project info
         project_name = "my-project"
         try:
-            apm_yml_path = project_root / APM_YML_FILENAME
+            apm_yml_path = apm_dir / APM_YML_FILENAME
             if apm_yml_path.exists():
                 root_package = APMPackage.from_apm_yml(apm_yml_path)
                 project_name = root_package.name
         except Exception:
             pass
-        
+
         # Try to load lockfile for accurate tree with depth/parent info
         lockfile_deps = None
         try:
             from ...deps.lockfile import LockFile, get_lockfile_path
-            lockfile_path = get_lockfile_path(project_root)
+            lockfile_path = get_lockfile_path(apm_dir)
             if lockfile_path.exists():
                 lockfile = LockFile.read(lockfile_path)
                 if lockfile:
@@ -460,7 +491,9 @@ def clean(dry_run: bool, yes: bool):
     show_default=True,
     help="Max concurrent package downloads (0 to disable parallelism)",
 )
-def update(packages, verbose, force, target, parallel_downloads):
+@click.option("--global", "-g", "global_", is_flag=True, default=False,
+              help="Update user-scope dependencies (~/.apm/)")
+def update(packages, verbose, force, target, parallel_downloads, global_):
     """Update APM dependencies to latest git refs.
 
     Re-resolves git references (branches/tags) to their current SHAs,
@@ -490,11 +523,14 @@ def update(packages, verbose, force, target, parallel_downloads):
             logger.progress(f"Import error: {_APM_IMPORT_ERROR}")
         sys.exit(1)
 
-    project_root = Path.cwd()
+    from ...core.scope import InstallScope, get_apm_dir
+    scope = InstallScope.USER if global_ else InstallScope.PROJECT
+    project_root = get_apm_dir(scope)
     apm_yml_path = project_root / APM_YML_FILENAME
 
     if not apm_yml_path.exists():
-        logger.error(f"No {APM_YML_FILENAME} found in current directory")
+        scope_hint = "~/.apm/" if global_ else "current directory"
+        logger.error(f"No {APM_YML_FILENAME} found in {scope_hint}")
         sys.exit(1)
 
     try: