akm -- Agent Knowledge Manager

Give every coding agent the capabilities your team has already built.

akm is a portable capability library for AI agents. Build your agent library once. Use it from any shell-capable coding agent. It indexes existing agent assets in place, loads only what a task needs, packages capabilities into shareable bundles, improves the library through reviewable proposals, and runs durable workflows -- locally and without tying the library to one assistant, including Claude Code, OpenCode, Cursor, and more.

Install

Option 1 — npm package (recommended; requires Node.js >= 22):

npm install -g akm-cli

Option 2 — Prebuilt binary (no runtime required):

# Linux / macOS
curl -fsSL https://github.com/itlackey/akm/releases/latest/download/install.sh | bash

# Windows (PowerShell)
irm https://github.com/itlackey/akm/releases/latest/download/install.ps1 | iex

Upgrade in place with akm upgrade.

The npm package always uses Node.js to bootstrap its cross-platform command. If a working Bun >= 1.0 is also on PATH, the launcher prefers Bun for execution; old, unusable, or absent Bun installations fall back to Node.js. Node.js remains required for the npm package. The standalone binaries are runtime-free.

Local semantic search runs its embedding model on ONNX Runtime and is offered on Linux x64 (glibc) and Apple-silicon macOS; every other platform uses keyword search or an embedding endpoint. Choosing it in akm setup (--embedding local) downloads the runtime (about 86 MB) and the model (about 127 MB) once into akm's cache: installing the package runs no install script and downloads nothing native. See Getting Started.

With a connection and no harness, agent work runs on akm's own runtime, a pinned OpenCode 2 binary. The first time it runs, akm downloads that binary from the npm registry (about 114 MB, once) into its cache; on Alpine/musl it needs libstdc++ and libgcc (the Alpine Node image has them). See Getting Started.

Quick Start

akm setup                          # Guided setup: configure, initialize, and index
akm bundle add github:owner/repo   # Add a bundle from GitHub
akm index                          # Index sources into the library
akm search "deploy"                # Find assets across all sources
akm show scripts/deploy.sh         # View details and run command

Why akm?

• One library for every agent -- Use the same capability library from Claude Code, OpenCode, Cursor, Aider, Windsurf, or any assistant that can run shell commands.
• Load only what the task needs -- Search or curate a shortlist, then load full content by ref. No giant startup prompt is required.
• Package complete capabilities -- Install and share bundles containing skills, scripts, workflows, agents, instructions, memories, and knowledge -- not just prompt snippets.
• Improve through evidence, with review -- Feedback re-ranks assets right away. A negative report can carry an exact text fix, and akm improve repairs metadata. Edits land as diffable proposals: the default improve strategy accepts the ones its quality judge passed, the rest wait for you to accept or reject, and any accept can be reverted. Only writable bundles are changed.
• Turn knowledge into repeatable work -- Run tasks on a schedule or on demand instead of reconstructing a process from prose every session. Workflows are Deprecated: 0.11 removes them, and tasks take over their ordered steps.

Search and show only return content; running a workflow, task, script, or agent is a separate command. akm complements MCP and assistant-native skills rather than replacing them.

Agent Integration

Add this to your AGENTS.md, CLAUDE.md, or system prompt:

## Resources & Capabilities

You have access to a searchable library of scripts, skills, commands, agents,
knowledge, instructions, memories, workflows, env files, secrets, lessons, tasks,
sessions, and facts via the `akm` CLI. Use `akm -h` for details.

Or generate it directly: akm hints --detail brief >> AGENTS.md

Documentation

Full docs, CLI reference, and guides are at akm.fwdslsh.dev:

• Getting Started
• Supported Formats
• CLI Reference
• Tasks Reference
• Migration guides
• Configuration
• Bundle Authoring Guide
• Registry

License

MPL-2.0