Claude Note CLI
Хуки Claude Code и Codex ищут по вашим заметкам и подсказывают известное решение до ответа и после падения команды.
- 88 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает записи ваших сессий и сохраняет выжимки в заметки на диске
- Меняет настройки хуков и файлы `CLAUDE.md` и `AGENTS.md`, добавляет почасовое задание
Установка
- Работает в
Ручная установка
git clone https://github.com/crimeacs/claude-note.git ~/src/claude-noteЗатем `scripts/install-from-checkout.sh --non-interactive --vault ~/Documents/notes --author you@example.com --claude-hooks` и `claude-note setup --codex`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает записи ваших сессий и сохраняет выжимки в заметки на диске
- Меняет настройки хуков и файлы `CLAUDE.md` и `AGENTS.md`, добавляет почасовое задание
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Note собирает то, чему научились сессии Claude Code, Codex, Cursor и ChatGPT, хранит это как типизированные заметки Markdown и подсовывает нужные агенту до действия: на каждом промпте и в момент ошибки команды. Хуки ставят сессии в очередь, фоновый процесс вытаскивает решения, подводные камни и приемы в заметки. Четыре режима работы: поиск перед ответом (хук проверяет заметки и добавляет краткий список со ссылками на источники, промах объявляется), сторож (при падении команды показывает известное исправление, ошибки авторизации, квоты и заполнения диска помечает «не повторять»), `claude-note remember` для ручной записи урока и `claude-note doctor` для проверки настройки. `claude-note eval` измеряет, попадает ли нужная заметка в ответ.
Для кого. Командам и одиночкам, у которых агенты снова и снова наступают на одни и те же грабли и забывают итоги прошлых сессий.
Подходит, если
- Агент собирается запустить сборку на сервере, где это ломает приложение, а заметка команды запрещает.
- Команда падает с ошибкой, для которой решение уже записано, и его надо показать до повторного запуска.
- Урок после отладки нужно записать как `gotcha`, `pattern` или `decision` одной командой.
- Нужно измерить, насколько часто поиск подбирает нужную заметку для вопросов из ваших записей.
Не подходит, если
- Нужна общая память команды в облаке: Claude Note хранит заметки в вашем хранилище на диске.
- Нельзя отправлять тексты сессий внешним моделям: для синтеза нужны Claude CLI и явная политика источников.
- Не хочется ставить поиск и расписание: установка добавляет хуки, правила в `CLAUDE.md` и почасовое обновление.
Пример запроса к агенту
Найди в заметках, что мы уже знаем про ошибку 403 после добавления области доступа Gmail, и покажи источник.Ограничения
Нужны Python 3.11 или новее, `uv`, поиск QMD и Claude CLI для синтеза. Установка выполняется из клона командой `scripts/install-from-checkout.sh`, затем `claude-note setup --codex`. Настройка идемпотентна и делает резервные копии всех файлов, которые меняет, а `--dry-run` показывает план. Она добавляет хуки, правило «искать заметки перед действием» в `~/.claude/CLAUDE.md` и `~/.codex/AGENTS.md` и почасовое обновление индекса. Внешние вызовы моделей требуют явной политики источников, существующие заметки считаются непроверенными подсказками. Хуки Codex работают после того, как вы одобрите их при первом запуске.
Как отключить. Уберите хуки и правила, которые добавил `claude-note setup`, из настроек Claude Code и Codex и из `~/.claude/CLAUDE.md` и `~/.codex/AGENTS.md`. Отмените почасовое обновление; хранилище заметок удаляют вручную.
Частые вопросы
Как проверить, что все работает?
Командой `claude-note doctor`: она отдельно проверяет настройку, изолированные хуки, реальный сервер и записанную доставку. Без нее легко принять настройку за работающую подсказку.
Как записать урок вручную?
Командой `claude-note remember --type gotcha --tags oauth "текст"`. Типы: `gotcha` для ошибок, `pattern` для приема, `decision` для принятого выбора.
Что делает сторож при ошибке?
Показывает известное исправление до повторного запуска. Ошибки авторизации, квоты и заполнения диска он помечает как «не повторять».
Что произойдет с существующей заметкой при повторной записи?
Если заметка с тем же названием есть, `remember` добавит блок с датой и ничего не перезапишет. Поиск показывает самый новый блок первым.
Как измерить пользу?
Командами `claude-note eval probes -n 80` и `claude-note eval run`: первая пишет вопросы по вашим заметкам, вторая проверяет, добавил ли поиск нужную заметку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПамять для Claude Code: хуки записывают решения человека и агента, оценка ставится задним числом, когда известен исход.
hipocampus дает агенту файловую память: индекс тем на 3000 токенов грузится в каждую сессию и подсказывает, что обсуждалось раньше
Рабочая папка для Claude Code: хуки с локальной Ollama определяют тип проекта, подбирают скиллы и напоминают вести документацию
CLI индексирует память, правила и сессии Claude Code, Codex, Cursor и Gemini и отдает проверенные решения всем агентам
agentcairn хранит память Claude Code, Codex и Cursor в Markdown-файлах для Obsidian и отдает агенту только нужное
Постоянная память для агентов: заметки хранятся карточками в markdown и находятся в начале следующей сессии.
Коротко о README
Описаны установка, обзор версии 2.1, режимы захвата, поиска и сторожа, повседневные команды, измерение качества поиска и политика обновлений.