Agent Wiki CLI
CLI awiki хранит память агентов в markdown-хранилище: поиск перед веб-запросом и запись того, что стоит сохранить.
- 56 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки правят настройки агента, а ingest скачивает страницы и сохраняет их текст в хранилище.
- Общий сервер раздает память по HTTP с токенами, поэтому нужна обычная защита сервиса.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-wikiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки правят настройки агента, а ingest скачивает страницы и сохраняет их текст в хранилище.
- Общий сервер раздает память по HTTP с токенами, поэтому нужна обычная защита сервиса.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agent Wiki делает из папки с markdown-файлами общую память агентов. Агент ищет в ней раньше, чем в вебе, а после работы записывает то, что стоит сохранить. Внутри только файлы с YAML-шапкой и ссылками `[[wikilinks]]`, базы данных нет, вести хранилище можно в Obsidian. Единая точка входа — CLI `awiki`. Команда `awiki ingest` копирует файл или скачивает страницу в неизменяемый архив `raw/` и пишет контрольную сумму sha256. `awiki search` ищет по нескольким словам, `awiki show` печатает страницу целиком. Для Claude Code, pi и OpenCode есть хуки, а `awiki guide` выдает блок для `CLAUDE.md` или `AGENTS.md`, где агента учат искать в вики первым делом.
Для кого. Тем, кто работает с несколькими агентами и проектами и хочет, чтобы найденные решения не терялись после закрытия сессии.
Подходит, если
- Агент решил капризную ошибку сборки, и разбор надо сохранить для следующих сессий.
- Статью или PDF по теме надо положить в архив с проверкой целостности и ссылками из страниц.
- Один сервер с хранилищем обслуживает несколько машин и проектов.
- Заметки хотят читать и править в Obsidian, а агент пишет в те же файлы.
Не подходит, если
- Нужна векторная база с семантическим поиском: поиск здесь словесный, на основе ripgrep.
- Каждая сессия должна начинаться с чистого листа, без накопленной памяти.
- Лицензия GPL-3.0 несовместима с политикой проекта.
Пример запроса к агенту
Найди в вики решение этой ошибки, а если нового, сохрани разбор отдельной страницей с тегами.Ограничения
Для CLI нужен Python 3.10 или новее; пакет называется `agent-wiki-kb` и ставит команды `awiki` и `agent-wiki`. Хуки для сессий записывают файлы в настройки агента: `awiki hook install --agent claude` меняет `~/.claude/settings.json`. Сетевой сервер `awiki serve` раздает хранилище по HTTP с токенами и ролями читателя, писателя и администратора, и его нужно защищать как обычный сервис. Скачанные страницы и PDF сохраняются в хранилище целиком, поэтому закрытые материалы туда лучше не класть. Лицензия GPL-3.0 или новее.
Как отключить. Выполните `awiki hook uninstall`: команда уберет только то, что записал awiki. Затем удалите пакет и папку хранилища, если память больше не нужна.
Частые вопросы
Как установить awiki?
Выполните `pip install agent-wiki-kb`, подойдут также `uv tool install` и `pipx install`. Затем создайте хранилище командой `awiki init <путь>`.
Как подключить Claude Code?
Команда `awiki hook install --agent claude` добавляет хук `SessionStart` в `~/.claude/settings.json`. Для pi и OpenCode вместо `claude` укажите `pi` или `opencode`.
Как агент узнает, что вики надо использовать?
Выполните `awiki guide` и скажите агенту вписать выданный блок в `CLAUDE.md` или `AGENTS.md`. Блок учит сначала искать, потом читать страницу целиком и сохранять полезное.
Можно ли делиться хранилищем между машинами?
Да: `awiki serve` публикует хранилище по HTTP, а на других машинах работает тот же `awiki`. Хранилище подключают командой `awiki init --remote <адрес> --token <секрет>`.
Нужна ли база данных?
Нет. Хранилище состоит из markdown-файлов, их можно читать через `grep`, открывать в Obsidian или обрабатывать скриптами на Python.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальная память для ИИ-агентов в обычных Markdown-файлах: запоминает только то, что вы одобрили, и отдает ее через MCP
CLI lwc на Rust: постоянная память агентов в виде вики с источниками на SQLite, подключение к Claude Code, Codex и Cursor
agentcairn хранит память Claude Code, Codex и Cursor в Markdown-файлах для Obsidian и отдает агенту только нужное
Долговременная память для ИИ-агентов: файлы Markdown как источник истины, индекс SQLite как кэш, общая у Claude Code, Codex и других
Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
ai-memory сохраняет опыт сессий в Markdown-вики, подключает поиск через MCP и передает контекст между агентами и машинами.
Коротко о README
Формат хранилища близок к Open Knowledge Format от Google. Индекс `index.md` и журнал `log.md` генерируются сами, а предписанной таксономии нет. Идея навеяна заметкой Карпати о вики для языковых моделей.