APM – Agent Package Manager

npm for AI coding agents. Package prompts, agents, and rules. Install once, native everywhere.

GitHub Copilot · Cursor · Claude · Codex · Gemini

Install

curl -sSL https://raw.githubusercontent.com/danielmeppiel/apm/main/install.sh | sh

Quick Start

One package. Every AI agent. Native format for each.

# Install from GitHub
apm install danielmeppiel/compliance-rules

# Install from awesome-copilot
apm install github/awesome-copilot/prompts/code-review.prompt.md

# Install Claude Skills
apm install ComposioHQ/awesome-claude-skills/brand-guidelines

# Compile instructions for your AI tools
apm compile

Done. Type /gdpr-assessment or /code-review in Copilot or Claude. It just works.

What APM Does

┌─────────────────────────────────────────────────────────────────┐
│  APM Packages (hosted on GitHub, Azure DevOps)                  │
│  ├── Guardrails   → Rules, compliance, standards                │
│  ├── Workflows    → Executable prompts, abilities               │
│  └── Personas     → Specialized AI agents                       │
└─────────────────────────────────────────────────────────────────┘
                              │
                    apm install && apm compile
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  Universal Output (auto-detected from .github/ and .claude/)    │
│  ├── AGENTS.md      → Instructions for Copilot, Cursor, Codex   │
│  ├── CLAUDE.md      → Instructions for Claude Code              │
│  ├── .github/       → VSCode native prompts & agents            │
│  └── .claude/       → Claude commands & skills                  │
└─────────────────────────────────────────────────────────────────┘

One package. Every AI agent. Native format for each.

Real Example: corporate-website

A production project using APM with layered guardrails:

# apm.yml
name: corporate-website
dependencies:
  apm:
    - danielmeppiel/compliance-rules    # GDPR, security, audit
    - danielmeppiel/design-guidelines   # Accessibility, UI standards

apm install && apm compile

→ View the full example

Commands

Command	What it does
apm install <pkg>	Add package to project
apm compile	Generate agent context files
apm init	Create new APM project
apm run <prompt>	Execute a workflow
apm deps list	Show installed packages

Install From Anywhere

# GitHub
apm install owner/repo

# GitHub Enterprise  
apm install ghe.company.com/owner/repo

# Azure DevOps
apm install dev.azure.com/org/project/repo

# Single file (Virtual Package)
apm install github/awesome-copilot/prompts/code-review.prompt.md

# Claude Skills
apm install ComposioHQ/awesome-claude-skills/brand-guidelines

Create Your Own Package

apm init my-standards && cd my-standards

This creates:

my-standards/
├── apm.yml              # Package manifest
├── SKILL.md             # Package meta-guide for AI discovery
└── .apm/
    ├── instructions/    # Guardrails (.instructions.md)
    ├── prompts/         # Workflows (.prompt.md)  
    └── agents/          # Personas (.agent.md)

Example guardrail:

cat > .apm/instructions/python.instructions.md << 'EOF'
---
applyTo: "**/*.py"
---
# Python Standards
- Use type hints for all functions
- Follow PEP 8 style guidelines
EOF

# Push and share
git add . && git commit -m "Initial standards" && git push

Anyone can now run: apm install you/my-standards

Installation Options

# Quick install (recommended)
curl -sSL https://raw.githubusercontent.com/danielmeppiel/apm/main/install.sh | sh

# Homebrew
brew tap danielmeppiel/apm-cli && brew install apm-cli

# pip
pip install apm-cli

Target Specific Agents

apm compile                    # Auto-detects from .github/ and .claude/ folders
apm compile --target vscode    # AGENTS.md + .github/ only
apm compile --target claude    # CLAUDE.md + .claude/ only
apm compile --target all       # Force all formats

Note: apm compile generates instruction files (AGENTS.md, CLAUDE.md). Prompts, agents, and skills are integrated by apm install into .github/ and .claude/ folders.

Advanced Configuration

For private packages, Azure DevOps, or running prompts via AI runtimes:

Token	Purpose
GITHUB_APM_PAT	Private GitHub packages
ADO_APM_PAT	Azure DevOps packages
GITHUB_COPILOT_PAT	Running prompts via apm run

→ Complete setup guide

---

Community Packages

Package	What you get
danielmeppiel/compliance-rules	/gdpr-assessment, /security-audit + compliance rules
danielmeppiel/design-guidelines	/accessibility-audit, /design-review + UI standards
DevExpGbb/platform-mode	Platform engineering prompts & agents
Add yours →

---

Documentation

Getting Started

Guide	Description
Quick Start	Complete setup, tokens, first project
Core Concepts	How APM works, the primitives model
Examples	Real-world patterns and use cases

Reference

Guide	Description
CLI Reference	All commands and options
Compilation Engine	Context optimization algorithm
Skills	Package meta-guides for AI discovery
Integrations	VSCode, Spec-kit, MCP servers

Advanced

Guide	Description
Dependencies	Package management deep-dive
Primitives	Building advanced workflows
Contributing	Join the ecosystem

---

Learn AI-Native Development → Awesome AI Native
A practical learning path for AI-Native Development, leveraging APM along the way.