SwarmVault CLI

Установка

Работает в

• Claude Code
• Codex
• Cursor
• GitHub Copilot
• Gemini CLI
• OpenCode
• Goose
• Amp
• Cline

npx skillfoxx add cli/swarmvault

Что делает

SwarmVault ставится из npm и превращает документы, код, заметки, стенограммы и адреса страниц в локальное хранилище трех слоев. В `raw/` лежат неизменяемые копии источников, в `wiki/` страницы Markdown, в `state/` граф знаний `graph.json` и поисковый индекс. Команда `swarmvault quickstart ./репозиторий` создает хранилище, загружает файл, папку или публичный репозиторий GitHub, собирает вики и граф и открывает локальный просмотр графа. Рядом лежат запросы: `swarmvault query` отвечает по вики, `swarmvault graph query`, `graph path`, `graph explain` и `graph callers` ходят по связям, в том числе по вызовам функций с указанием файла и строки. К агенту хранилище подключается явной командой `swarmvault install --agent <имя>`, по умолчанию ни `init`, ни `quickstart` правил в проект не пишут. Для Claude Code флаги `--hook` и `--mcp` добавляют хуки и запись в `.mcp.json`. Хук в начале сессии советует сначала спросить граф и только потом искать по файлам, а после правок запускает фоновое обновление графа для измененного файла. Команда `swarmvault mcp` отдает то же хранилище любому MCP-клиенту по stdio. Связи графа помечены как извлеченные, предположенные или неоднозначные. Новые понятия сначала попадают в `wiki/candidates/`, а `compile --approve` складывает изменения в пакеты на одобрение. Для первого запуска ключи не нужны: встроенный эвристический провайдер работает офлайн. Для более точного извлечения подключают Ollama или облачные модели, ключ задается именем переменной среды.

Для кого. Для тех, кто ведет в Claude Code, Codex или Cursor большой проект или исследование с десятками документов и хочет, чтобы агент находил связи по графу, а не перечитывал файлы.

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

Собери из папки docs и исходников этого репозитория хранилище SwarmVault и покажи, кто вызывает функцию parseConfig

Ограничения

• Нужен Node 24 или новее. Установка глобальная, через `npm install -g @swarmvaultai/cli`.
• Без модели работает эвристический провайдер: он годится для офлайн-запуска и легкого извлечения, а для более точного извлечения нужны Ollama или облачная модель. Облачный провайдер получает текст ваших источников.
• Провайдер `local-whisper` для расшифровки аудио в документации помечен как экспериментальный, для работы он скачивает модель около 147 МБ.
• Хуки по умолчанию только подсказывают порядок поиска. Запрет первого широкого поиска включается флагом `--graph-first` и в сессии срабатывает один раз.
• Команда `swarmvault install` дописывает каталоги хранилища в `.gitignore` и в `exclude` строгих `tsconfig.json`, чтобы копии исходников в `raw/` не ломали проверку типов проекта.

Как отключить. Для одного агента выполните `swarmvault install status --agent claude`, чтобы увидеть записанные файлы, и удалите их: хуки в настройках, запись `swarmvault` в `.mcp.json`, папку `.claude/skills/swarmvault`. Хранилище остается обычными каталогами `raw/`, `wiki/` и `state/` в проекте, их можно удалить вместе с `swarmvault.config.json`. Глобальный пакет снимает `npm uninstall -g @swarmvaultai/cli`.

Коротко о README

В репозитории лежат монорепозиторий пакетов CLI и движка на TypeScript, документы о стабильности и масштабе, Dockerfile с метаданными для реестров MCP-серверов. Обзор начинается с запуска за 30 секунд, сравнения с исходной идеей Андрея Карпати и таблицы из тридцати с лишним форматов входных данных. Далее перечислены настройка моделей, подключение более чем к тридцати агентам и режимы автоматизации. Есть переводы на китайский и японский. Лицензия MIT.