Repolode
microsoft

microsoft/apm

A dependency manager for AI coding agent configuration, letting teams declare skills, prompts, agents, plugins and MCP servers in one apm.yml file.

Stars
4,277
Forks
416
Open issues
227
Last commit
yesterday

What is it?

APM (Agent Package Manager) brings package-manager semantics to the context that AI coding agents use. Instead of each developer manually copying instructions, skills, prompts and MCP server settings into their tools, a project declares them in an apm.yml manifest, and running apm install writes the matching configuration for each supported agent. A lockfile, apm.lock.yaml, pins the resolved dependency tree, including transitive dependencies, so every clone gets the same setup.

Packages can be pulled from GitHub, GitLab, Bitbucket, Azure DevOps and other git hosts, and marketplaces can be added as sources. Targets include GitHub Copilot, Claude Code, Cursor, Codex, Gemini, Windsurf, Kiro and others. APM can also compile instructions into files such as .github/copilot-instructions.md and package configurations as standard plugin.json bundles.

For security and governance, install scans for hidden Unicode in agent context, lockfiles record content hashes, and an apm-policy.yml file can restrict allowed sources, scopes and primitives. The project is written in Python and installable via Homebrew, pip, WinGet or Scoop.

Key features

  • 01Declare skills, prompts, agents, instructions, hooks and MCP servers in one apm.yml manifest.
  • 02Deploys the same configuration to Copilot, Claude, Cursor, Codex, Gemini and other agents.
  • 03Lockfile pins the full dependency tree, including transitive dependencies.
  • 04Installs packages from GitHub, GitLab, Azure DevOps and other git hosts.
  • 05Scans installed agent context for hidden Unicode and checks content hashes.
  • 06Policy file restricts which sources and primitives an organization allows.

Use cases

  • Sharing a consistent set of coding-agent instructions and skills across a team repository.
  • Reproducing the same AI agent setup on every developer machine and in CI.
  • Authoring and packaging reusable plugins for Copilot, Claude or Cursor.
  • Enforcing approved-source policies for AI agent configuration in an enterprise.

Quick start

  1. 1

    Install APM with Homebrew on macOS

    brew install apm
  2. 2

    Or install APM with pip (Python 3.10+)

    pip install apm-cli
  3. 3

    Install the sample package

    apm install microsoft/apm-sample-package#v1.0.0

In collections

Topics

FAQ

What is apm?
A dependency manager for AI coding agent configuration, letting teams declare skills, prompts, agents, plugins and MCP servers in one apm.yml file. APM (Agent Package Manager) brings package-manager semantics to the context that AI coding agents use. Instead of each developer manually copying instructions, skills, prompts and MCP server settings into their tools, a project declares them in an apm.yml manifest, and running apm install writes the matching configuration for each supported agent. A lockfile, apm.lock.yaml, pins the resolved dependency tree, including transitive dependencies, so every clone gets the same setup.
Is apm free to use? What license does it have?
apm is open source under the MIT license. Check the license terms before using it in commercial products.
Is apm still maintained?
Actively maintained. The last commit to apm was on Nov 6, 2026.
What can I use apm for?
Sharing a consistent set of coding-agent instructions and skills across a team repository. Reproducing the same AI agent setup on every developer machine and in CI. Authoring and packaging reusable plugins for Copilot, Claude or Cursor. Enforcing approved-source policies for AI agent configuration in an enterprise.
How do I install apm?
Install APM with Homebrew on macOS: brew install apm Or install APM with pip (Python 3.10+): pip install apm-cli Install the sample package: apm install microsoft/apm-sample-package#v1.0.0
Where can I get apm?
The source code and installation instructions are on GitHub: https://github.com/microsoft/apm

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects