Commands

AGPM provides a set of commands for managing AI tool artifacts. Here's an overview of all available commands.

Artifact Management

CommandDescription
agpm add <source> [artifact[@version]]Add an artifact to your project
agpm installInstall all configured artifacts
agpm listShow configured artifacts and their status
agpm remove <artifact>Remove an artifact from your project
agpm update [artifact]Update lock file to latest SHAs

Source Management

CommandDescription
agpm source add <repo>Add a source repository
agpm source listList configured sources
agpm source remove <repo>Remove a source
agpm source discover <repo>Show available artifacts in a source

Command Details

agpm add

Add an artifact to your project configuration.

# Add from a source
agpm add anthropics/skills pdf

# Add with version pin
agpm add anthropics/skills pdf@v1.0.0

agpm install

Install all configured artifacts to target directories.

agpm install

This command:

  1. Reads your agpm.json configuration and configured targets
  2. Resolves refs to SHAs (creates/updates agpm-lock.json)
  3. Caches repo at SHA to ~/.agpm/cache/<sha>/
  4. Copies artifacts to enabled target directories (e.g., .claude/skills/)

agpm list

Display all configured artifacts and their status.

agpm list

agpm update

Update the lock file with the latest versions from sources.

# Update all artifacts
agpm update

# Update a specific artifact
agpm update anthropics/skills/pdf

agpm source add

Add a new source repository.

# GitHub shorthand
agpm source add anthropics/skills

# With subpath
agpm source add owner/repo#subdirectory

# Full URL
agpm source add https://github.com/owner/repo

agpm source discover

Discover available artifacts in a source.

agpm source discover anthropics/skills

This shows all artifacts, their descriptions, and metadata from the repository.