Getting Started

Prerequisites

AKM requires one runtime dependency:

  • git — For skills sync, repo detection, and artifact sync

Install

Quick install (Linux x86_64 / macOS ARM)

Download the latest release binary:

curl -fsSL https://akm.raphaelsimon.fr/install | sh

This downloads the latest release binary to ~/.local/bin/akm. The installer auto-detects your platform and downloads the correct binary.

Supported platforms:

Platform Architecture Asset
Linux x86_64 akm-linux-x86_64 (static, musl)
macOS Apple Silicon (M1+) akm-macos-aarch64

Other platforms (Linux ARM, Intel Mac) can install via cargo install akm.

Options:

# Install a specific version
AKM_VERSION=1.0.0 curl -fsSL https://akm.raphaelsimon.fr/install | sh

# Install to a custom directory
AKM_INSTALL_DIR=/usr/local/bin curl -fsSL https://akm.raphaelsimon.fr/install | sh

From crates.io

If you have Rust installed:

cargo install akm

From source

git clone https://github.com/akm-rs/akm-rs.git
cd akm-rs
cargo install --path .

Setup

Run the interactive setup wizard:

akm setup

Setup asks about each domain:

  1. Enable skills? (Y) – Installs the cold library and sets up three-layer activation
  2. Use Skillverse? (Y) – Configures Skillverse as your community registry
  3. Personal registry? – Optionally configure a personal registry for publishing your own skills
  4. Enable artifacts/instructions? – Configure artifact sync and global instructions

The happy path is Enter through everything – defaults work out of the box.

Verify

Open a new terminal (or source ~/.bashrc), then check your installation:

# Full status overview
akm skills status

# Browse installed skills
akm skills list

Shell Wrappers

akm setup wires akm-init.sh into your .bashrc, which provides wrapper functions for claude, copilot, vibe, and opencode. These wrappers automatically:

  1. Pull latest artifacts (if enabled)
  2. Create a per-session skills staging directory with manifest specs loaded
  3. Pass artifact and staging dirs to the tool via --add-dir
  4. On exit: destroy staging dir, commit+push artifacts (if auto-push enabled)

This means you just type claude or copilot as usual – AKM handles skills and artifacts transparently.

Next Steps