Practical overview
When it fits
Use APM when agent context needs to be managed as project dependencies, shared across developers or governed by installation policy. It is also relevant when packaging agent plugins or configuring MCP servers as part of a repository's setup.
Who it is for
- Developers who want agent configuration declared and versioned with a project repository.
- Teams seeking a repeatable setup across supported coding-agent tools.
- Maintainers who want to author, bundle or distribute agent configuration packages and plugins.
Documented uses
- Declare agent configuration dependencies in apm.yml and resolve them, including transitive dependencies.
- Install shared configuration from supported Git hosts and reproduce a project setup using a lockfile.
- Compile configuration for GitHub Copilot into .github/copilot-instructions.md.
- Create plugins with dependency management and export plugin.json packages.
- Set installation policies and inspect configuration through audit, drift-detection and SBOM features.
Requirements & limits
APM is presented as an open-source CLI project with an MIT license. Its documented implementation is in Python.
- Configuration is declared in apm.yml, with apm.lock.yaml recording resolved dependencies and content hashes.
- Documented targets include GitHub Copilot, Claude Code, Grok Build, Cursor, OpenCode, Codex, Gemini, Windsurf and Kiro.
- The project documents installation checks, MCP consent gates, auditing, policy enforcement and drift detection.
- The policy controls what gets installed; the agent harness controls what runs.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install agent dependencies from an APM manifest
Reproduce the agent configuration declared in a repository’s apm.yml.
Before you start
- A repository containing an apm.yml manifest.
- The APM CLI available to run the documented apm install command.
Steps
Clone the repository and change into its directory: git clone && cd .
Run apm install to install the declared agent dependencies.
Expected outcome
APM installs the dependencies declared in the manifest, including resolved transitive dependencies, to configure detected agent clients.
Guide limitations
- The example uses a placeholder repository path; no particular repository or dependency set is specified.
- No agent execution or deployment procedure is documented.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 10 October 2026
- Original website title
- microsoft/apm · Official homepage title · retained in its source language

