Installing Artifacts

Install a single artifact

cmx agent install python-craftsperson
cmx skill install skill-creator

If the artifact exists in multiple sources, cmx will ask you to disambiguate:

cmx agent install guidelines:python-craftsperson

cmx agent install --all
cmx skill install --all

This installs every artifact from registered sources that isn't already tracked in the lock file with a matching version.

By default, artifacts install globally (~/.claude/agents/ or ~/.claude/skills/).

Use --local to install into the current project:

cmx agent install python-craftsperson --local

This installs to .claude/agents/ in the current directory.

The artifact is copied to the appropriate platform directory
A SHA-256 checksum is computed
The version (if present in frontmatter) is recorded
An entry is written to the lock file with source, checksum, version, and timestamp