apm usage
- Repo stars 2,746
- Author repo apm
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @microsoft · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# APM Usage
APM (Agent Package Manager) is the open-source package manager for AI coding
agents. It lets teams install, share, and govern reusable instructions, prompts,
agents, skills, and MCP server configurations across projects.
## When to activate
- User mentions `apm` or "Agent Package Manager"
- Questions about installing or managing AI-agent packages
- Setting up instructions, prompts, agents, skills, or chatmodes
- Configuring MCP servers through apm.yml
- Authentication for private repos (GitHub, ADO, GHES, Artifactory)
- Policy enforcement or `apm audit`
- Package authoring or publishing
- Compiling agent context (`apm compile`)
- Troubleshooting apm errors
## Key rules
- **Commit these files:** apm.yml, apm.lock.yaml, .apm/, .github/, .claude/, .cursor/
- **Never commit:** apm_modules/ (add to .gitignore)
- **Team sync:** after `git clone`, run `apm install` to restore dependencies
- **Update deps:** `apm install --update` refreshes to latest refs
- **Pin versions:** use tags (`#v1.0.0`) in production, branches for development
- **ASCII only:** all CLI output and source must stay within printable ASCII
## Reference
For detailed guidance, see the following resources:
- [Installation](./installation.md) -- install and update APM
- [Workflow](./workflow.md) -- core workflow, apm.yml format, what to commit
- [Commands](./commands.md) -- full CLI command reference
- [Dependencies](./dependencies.md) -- all dependency formats and version pinning
- [Authentication](./authentication.md) -- token setup for private repos
- [Governance](./governance.md) -- policy engine and audit checks
- [Package Authoring](./package-authoring.md) -- creating APM packages
- [Troubleshooting](./troubleshooting.md) -- common errors and fixes
Sections and files
Listed in source order.
sections -> When to activate → Key rules → Reference
terms -> Commit these files · Never commit · Team sync · Update deps · Pin versions · ASCII only
files/cmd -> apm · apm audit · apm compile · git clone · apm install · apm install --update · #v1.0.0
body sha256 -> 0dd58fe42cd3
When to activate
User mentions
apmor "Agent Package Manager" Questions about installing or managing AI-agent packages Setting up instructions, prompts, agents, skills, or chatmodes Configuring MCP servers through apm.yml Authentication for private repos (GitHub, ADO, GHES, Artifactory)Key rules
Commit these files: apm.yml, apm.lock.yaml, .apm/, .github/, .claude/, .cursor/ Never commit: apm_modules/ (add to .gitignore) Team sync: after
git clone, runapm installto restore dependencies Update deps:apm install --updaterefreshes to latest refs Pin versions: use tags (#v1.0.0) in production, branches for developmentReference
For detailed guidance, see the following resources: Installation -- install and update APM Workflow -- core workflow, apm.yml format, what to commit Commands -- full CLI command reference Dependencies -- all dependency formats and version pinning