akm — Agent Knowledge Manager

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

Build your agent library once. Use it from any shell-capable coding agent.

Every coding agent wants its own copy of your team's knowledge — an AGENTS.md here, a tool-specific skills folder there, prompts scattered across repos and chat logs. AKM 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. The core loop is connect -> index -> curate -> show -> use/run -> feedback -> proposal (not every task uses every stage).

Use the same capability library from Claude Code, OpenCode, Cursor, Aider, Windsurf, or any assistant that can run shell commands.

Search or curate a shortlist, then load full content by ref. No giant startup prompt is required.

Install and share bundles containing skills, scripts, workflows, agents, instructions, memories, and knowledge — not just prompt snippets.

Feedback influences retrieval and produces diffable proposals. Changes remain reviewable and target only writable bundles.

Run persisted workflows with dispatch, gates, retries, budgets, and resume instead of reconstructing a process from prose every session.

AKM retrieves every supported capability type. It directly orchestrates defined execution surfaces such as workflows, agent dispatch, tasks, and guarded subprocess injection. It does not blindly execute arbitrary indexed content merely because that content appears in search results.

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: 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.

akm setup --yes                          # guided first-time setup, non-interactive
akm bundle add github:itlackey/akm-stash # install the official onboarding capability bundle
akm index                                # build the search index
akm curate "deploy a Bun app"            # get a curated shortlist
akm show workflows/deploy                # load the best match by ref

Then tell your agent AKM exists:

akm help agents >> AGENTS.md

AKM recognizes several existing directory layouts in place, each through its own adapter, alongside its own native bundle format:

See Supported Formats for current write support and detection rules, and Wikis for using a living LLM wiki as a bundle.

• Connect local dirs, git repos, npm packages, and websites — Bundles
• Capture memories, import docs, and manage wikis — Capture Knowledge
• Turn feedback and usage into reviewable proposals — Improve the Library
• Run resumable, multi-step procedures — Workflows
• Wire akm into Claude Code, OpenCode, Cursor, and other assistants — Use AKM With Any Agent

Scheduling background tasks (like akm improve) involves reviewing and activating OS scheduler entries — see Scheduling for the full walkthrough.

AKM is local-first: it stores its index and state on disk and has no remote telemetry. The network is only used for sources and endpoints you explicitly configure — Git, npm, website sources, registries, and your own model endpoints. See Data & Telemetry for the complete on-disk inventory and how to inspect or clear local data.

MPL-2.0