akm CLI

akm индексирует скиллы, команды, агентов и заметки в одном месте и отдает агенту только нужное под задачу

  • 70 ★ репозитория
  • Последний коммит
  • MPL-2.0
CLI

Расширенный доступ

Почему такой уровень

  • CLI индексирует локальные папки, git, npm и сайты и может запускать воркфлоу, скрипты и агентов отдельной командой
  • Планировщик задач вроде `akm improve` требует активации записей в системном расписании
Все причины и проверки

itlackey/akm

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add cli/akm

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • CLI индексирует локальные папки, git, npm и сайты и может запускать воркфлоу, скрипты и агентов отдельной командой
  • Планировщик задач вроде `akm improve` требует активации записей в системном расписании

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

akm (Agent Knowledge Manager) — CLI, который собирает в одну библиотеку то, что команда уже написала для агентов: `AGENTS.md` и `CLAUDE.md`, папки `commands/`, `agents/` и `skills/`, отдельные пакеты Agent Skills, файлы воркфлоу и вики на Markdown. Источником может быть локальная папка, git, пакет npm или сайт, который akm сохраняет локальным снимком. Форматы Claude Code и OpenCode индексируются на месте и только для чтения, собственные пакеты akm доступны для записи. Рабочий цикл такой: `akm index` строит индекс, `akm curate "deploy a Bun app"` возвращает короткий список, `akm show <ref>` загружает выбранный материал по ссылке. Поиск и показ только возвращают содержимое, запуск воркфлоу, задачи, скрипта или агента идет отдельной командой. Агенту про akm сообщает `akm hints --detail brief >> AGENTS.md`. Материалы упаковываются в пакеты со скиллами, скриптами, воркфлоу, агентами, инструкциями и памятью, ими делятся через `akm bundle add`. Отзывы переранжируют материалы сразу, а `akm improve` оформляет правки как проверяемые предложения: часть принимается автоматически по оценке качества, остальные ждут вашего решения. Воркфлоу идут с шагами, условиями, повторами, бюджетами и возобновлением, этот раздел помечен экспериментальным.

Для кого. Командам, у которых скиллы, промпты и инструкции разбросаны по репозиториям и разным агентам и нужна одна библиотека для Claude Code, OpenCode и Cursor.

Подходит, если

  • В каждом репозитории свой `AGENTS.md` и своя папка скиллов, и их надо искать из одного места
  • Агенту не нужен огромный стартовый промпт: он берет короткий список через `akm curate` и грузит материал по ссылке
  • Пакет скиллов, скриптов и воркфлоу нужно передать коллеге командой `akm bundle add`
  • Отрицательный отзыв о материале должен превращаться в проверяемую правку через `akm improve`
  • Повторяемую процедуру удобнее запускать как воркфлоу с возобновлением, чем объяснять заново каждую сессию

Не подходит, если

  • Агентов у вас один, а материалов десяток файлов: хватит обычных `AGENTS.md` и скиллов
  • Агент не умеет запускать команды оболочки: akm работает через них
  • Нужен локальный семантический поиск на Windows или Linux ARM: встроенная модель есть для Linux x64 и macOS на Apple Silicon
  • Воркфлоу нужны в стабильном виде: этот раздел экспериментальный

Пример запроса к агенту

Подключи akm к этому проекту, построй индекс и подбери через `akm curate` материалы для выката приложения на Bun

Ограничения

  • Нужен агент, который умеет запускать команды оболочки. Для пакета npm требуется Node.js 22 или новее, отдельные бинарные сборки обходятся без среды выполнения.
  • Локальный семантический поиск доступен на Linux x64 (`glibc`) и macOS на Apple Silicon: загрузка рантайма около 86 МБ и модели около 127 МБ. На других платформах работает поиск по ключам или внешний адрес API.
  • Без подключенного агента работа идет на собственном рантайме akm: при первом запуске скачивается закрепленный бинарник OpenCode 2 около 114 МБ.
  • Воркфлоу помечены Experimental, а формат Claude Code и OpenCode индексируется только для чтения.

Как отключить. Строку про akm из `AGENTS.md` удаляют вручную, а источники отключают командами `akm` для источников и пакетов. Сам CLI удаляет `npm uninstall -g akm-cli`, а для бинарной сборки хватает удаления файла. Индекс и состояние лежат на диске, телеметрии нет.

Частые вопросы

Как установить akm?

Выполните `npm install -g akm-cli` (нужен Node.js 22 или новее) или скачайте бинарную сборку скриптом `install.sh` из релизов. Обновление идет командой `akm upgrade`.

С какими агентами работает akm?

Claude Code, OpenCode, Cursor, Aider, Windsurf и любой ассистент, который запускает команды оболочки. Привязки к одному агенту нет.

Меняет ли akm мои файлы скиллов?

Материалы Claude Code, OpenCode и отдельные пакеты Agent Skills индексируются только для чтения. Правки идут в собственные пакеты akm и оформляются как предложения, которые можно отменить.

Отправляет ли akm данные наружу?

Телеметрии нет. Сеть используется только для указанных вами источников: Git, npm, сайтов, реестров, ваших моделей и Hugging Face при загрузке локальной модели эмбеддингов.

С чего начать после установки?

Выполните `akm setup --yes`, затем `akm bundle add github:itlackey/akm-stash` для официального пакета знакомства, `akm index` и `akm curate "ваш запрос"`.

Обсуждение

Вопросов и отзывов пока нет.

Официальный

AKB — база знаний для агентов на PostgreSQL: документы, таблицы и файлы в хранилищах, поиск и связи через MCP.

MCP-серверШирокий доступ168Звезды репозитория

CLI awiki хранит память агентов в markdown-хранилище: поиск перед веб-запросом и запись того, что стоит сохранить.

CLIРасширенный доступ56Звезды репозитория

Базовый AGENTS.md и 12 скиллов: передача задач Codex, Grok, Devin и Antigravity, планирование, тексты, узкие правки.

СкиллРасширенный доступ227Звезды репозитория

Команда ak ставит, чинит и проверяет ruflo и agentic-qe, добавляет офлайн-базу RuvNet Brain и связывает Claude Code с Codex

CLIРасширенный доступ61Звезды репозитория

Одна конфигурация для Claude Code и Codex в любом репозитории: общие правила, пакеты скиллов, ревью второй моделью и защитный хук

CLIШирокий доступ261Звезды репозитория

Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других

CLIШирокий доступ1,4 тыс.Звезды репозитория

Коротко о README

README объясняет, зачем нужна единая библиотека знаний для агентов, дает пять причин, затем установку и «первый полезный результат» из пяти команд. Дальше таблица поддерживаемых форматов, следующие шаги, раздел о локальности и приватности и список репозиториев экосистемы.

Бейдж для README

Сообщить о проблеме