scribe CLI
scribe собирает из репозиториев и сессий агентов личную вики на Markdown, которую Claude Code и Codex читают перед ответом
- 69 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает git-репозитории, сессии кодинг-агентов и, если включить, сообщения iMessage самому себе, а затем отправляет их текст выбранной модели
- Дописывает блок в ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md и ~/.config/amp/AGENTS.md и меняет поведение агентов
- Ставит фоновые задания по расписанию и на macOS требует Full Disk Access
Установка
- Работает в
Ручная установка
brew tap oliver-kriska/scribe && brew install oliver-kriska/scribe/scribeHomebrew на macOS и Linuxbrew. Нужны также ccrider, qmd и sqlite3.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает git-репозитории, сессии кодинг-агентов и, если включить, сообщения iMessage самому себе, а затем отправляет их текст выбранной модели
- Дописывает блок в ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md и ~/.config/amp/AGENTS.md и меняет поведение агентов
- Ставит фоновые задания по расписанию и на macOS требует Full Disk Access
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
scribe — одиночный бинарник на Go, который по расписанию вытягивает знания из ваших git-репозиториев, из сессий кодинг-агентов, проиндексированных ccrider, из заметок iMessage самому себе и из локальных файлов. Сырые источники он хранит дословно в папке raw, а поверх собирает вики со ссылками между статьями. Вики лежит в вашем приватном git-репозитории обычным Markdown с метаданными в YAML, поиск по ней ведет qmd. Команда scribe init создает хранилище из шаблонов, спрашивает имя базы, домены и имя владельца и дописывает блок в ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md и ~/.config/amp/AGENTS.md. Блок велит агенту сначала искать в базе: перед выбором библиотеки, перед архитектурным решением и когда вы ссылаетесь на прошлую работу. Все шаги с моделью идут через один блок llm в scribe.yaml: по умолчанию Claude, а вместо него можно указать локальный Ollama с моделями qwen3 или gemma, тогда конвейер обходится без платного API. Команда scribe cron install ставит набор LaunchAgents на macOS, на Linux README дает готовые строки для crontab. Раз в два часа программа просматривает репозитории, три раза в сутки разбирает сессии агентов, в 07:30 пишет отчет scribe `doctor` и при сбоях создает файл NEEDS-ATTENTION.md.
Для кого. Разработчикам, которые ведут несколько проектов в Claude Code или Codex и устали заново объяснять агенту прошлые решения и отвергнутые библиотеки.
Подходит, если
- Агент снова советует библиотеку, которую вы оценили и отклонили полтора месяца назад
- Решение по архитектуре принято в одной сессии, а нужно в другом проекте через неделю
- Хочется копить личную базу знаний в git, не набирая вручную каждую заметку: ссылку можно просто отправить самому себе в iMessage
- Нужна полностью локальная сборка знаний на Ollama без платных запросов к API
- Требуется ежедневный отчет о здоровье конвейера и список того, что сломалось
Не подходит, если
- Вы работаете в Windows: документация рассчитана на macOS и Linux, на macOS закрыты и права Full Disk Access
- Нужна общая командная вики с совместным редактированием: scribe пишет личную приватную базу одного человека
- Не хочется ставить ccrider и qmd: оба обязательны для разбора сессий и поиска
- Агент не должен получать правки в ~/.claude/CLAUDE.md: блок записывается при init, его отключают флагами --no-claude-md, --no-codex-md и --no-amp-md
Пример запроса к агенту
Поставь scribe через Homebrew, создай базу знаний в ~/my-kb и покажи оценку расходов перед первым запускомОграничения
- Для разбора сессий нужны ccrider и qmd, для чтения iMessage и сессий нужен sqlite3, остальное необязательно (trafilatura, jq, fzf).
- Заметки iMessage читаются из chat.db, поэтому на macOS бинарнику выдают Full Disk Access командой scribe fda. После обновления через brew права иногда нужно подтвердить заново.
- Выбор модели меняет расходы: по умолчанию вызывается Claude через claude -p, оценку расходов дает scribe sync --dry-run --estimate.
- Расписание ставят LaunchAgents на macOS, на Linux строки для crontab вставляют вручную.
- Сборка из исходников требует Go 1.26 и компилятор C для go-sqlite3 с FTS5.
Как отключить. Команда scribe cron uninstall снимает LaunchAgents. Блоки в ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md и ~/.config/amp/AGENTS.md удалите вручную: вики остается в вашем git-репозитории обычными файлами Markdown.
Частые вопросы
Чем scribe отличается от обычной RAG-схемы?
scribe хранит сырые источники дословно и поверх них собирает вики из статей со ссылками. Плотный источник раскладывается на несколько страниц по сущностям, к статьям добавляются абзацы с контекстом для поиска. Поиск по обоим слоям ведет qmd.
Как заставить Claude Code читать базу знаний?
Команда scribe init сама пишет блок в ~/.claude/CLAUDE.md. Блок называет вашу базу и просит искать в ней через MCP qmd до рекомендаций и архитектурных решений. Для Codex и Amp блоки уходят в ~/.codex/AGENTS.md и ~/.config/amp/AGENTS.md.
Можно ли обойтись без платного API?
Да. В блоке llm файла scribe.yaml укажите локальный Ollama с моделью qwen3, gemma4 или gemma3, и весь конвейер работает без платных запросов. Одной строкой его переключают обратно на Claude.
Что читает scribe с моего компьютера?
Git-репозитории из настроенных путей, сессии агентов из базы ccrider, локальные файлы и, если вы задали свой номер, сообщения iMessage самому себе из chat.db. Чужую переписку программа не разбирает по замыслу автора: для заметок используется ваш собственный номер.
Какие агенты читают базу знаний scribe?
Claude Code, Codex и Amp: init пишет блок в их пользовательские файлы CLAUDE.md и AGENTS.md. Сессии для разбора берутся из базы ccrider, куда попадают Claude Code, Codex CLI, GitHub Copilot CLI, OpenCode, Pi и Antigravity.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыВоркфлоу для Claude Code, Codex и Gemini CLI: агент сам заносит источники в постоянную связанную вики
CLI заводит хранилище Markdown для Obsidian и ставит четыре скилла, по которым агент ведет базу знаний.
Набор скиллов, с которыми агент ведет личную вики в Obsidian: собирает знания из документов и прошлых сессий и отвечает со ссылками
Одна настройка Claude Code и Codex через диалог: общие инструкции, правила, плагины, скиллы, статусная строка и память поправок
Заметки, задачи, контакты и контекст проектов лежат в Markdown на вашем диске, и Claude Code с Codex читают одну и ту же память
Шаблон хранилища Obsidian, где скиллы лежат рядом с заметками, решениями и обратной связью для Claude Code и Codex.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| scribe (эта карточка) | нет | 69 | ||
| QMD | нет | не нужна | 31 078 | qmd только ищет по заметкам, а scribe еще и создает и пополняет вики из репозиториев и сессий |
| LLM Wiki Compiler | нет | 2 254 | компилятор вики из заданных источников, без расписания и разбора сессий агентов |
Коротко о README
README объясняет идею базы знаний как рабочей памяти агента, показывает дерево хранилища, цикл «работа, сессия, извлечение, статья» и расписание заданий. Дальше идут установка через Homebrew и скрипт, список зависимостей, мастер init, настройка qmd, права Full Disk Access и подробности по отчету `doctor` и контролю расходов.