Getting started

Use AXM to manage agent skills, rules, subagents, MCP server connections and more in your projects. Learn more

Copy and paste the prompt below into your agent to install and setup AXM:

Install and setup AXM with https://axm.sh/install.md

curl -fsSL https://axm.sh/install.sh | sh

irm https://axm.sh/install.ps1 | iex

curl -fsSL -o install.cmd https://axm.sh/install.cmd && install.cmd

brew install agentxm/tap/axm

npm install -g axm.sh

After installation, verify the CLI is available:

axm --version

Public discovery, public installation, and local authoring do not require an account. Sign in when publishing or accessing private extensions.

Once AXM is installed, run axm setup inside a project to bootstrap its configuration:

axm setup

The command detects the coding agents in your project and prompts you to select which one(s) AXM should manage — so skills and extensions sync to the right places. It then creates project-root axm.json to record your selection; .axm/ is reserved for ignored runtime scratch.

A skill is a reusable instruction module that teaches your agent a specific capability — like how to review a diff against your conventions. Install one from the AgentXM.ai registry:

axm skills install @acme/skills/code-review

Then sync it into every coding agent you configured during setup:

axm sync

That writes the skill into the universal .agents/skills/code-review location plus each agent's native directory (.claude/skills/code-review for Claude Code, and so on). One install; it's available everywhere you work.

Now make a small code change in your project, then ask your coding agent to review it:

Review my changes before I open a pull request.

A supporting host uses skill metadata to discover relevant instructions. Check whether it selects the installed skill and follows its guidance; host settings and model behavior affect activation. If needed, explicitly ask it to use the skill and consult your host's skill-discovery controls.

Operational sources: axm help getting-started and axm help basic-usage for your installed CLI. This walkthrough was reconciled with AXM 0.51.0.

You have a working skill. Build on it:

• Create a skill — author your own from scratch.
• Add an MCP server connection — give your agent live tools and data sources.
• Add a subagent — delegate focused tasks to a specialized agent.
• Bundle into a pack — group skills, subagents, and MCP server connections into one installable unit.
• Publish and share — push your extensions to the registry for your team or the world.

To understand what's happening under the hood, read How AXM works. For every command and flag, see the CLI reference.