Obelisk CLI
CLI и скилл собирают историю сессий кодовых агентов в одну базу SQLite, по которой агент ищет прошлые решения
- 700 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Читает полные тексты всех сессий агентов на машине, а в них могут быть вставленные ключи и пароли
- Агент пишет и запускает JS-запросы к базе локально, а память регистрируется только после вашего одобрения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/obeliskОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает полные тексты всех сессий агентов на машине, а в них могут быть вставленные ключи и пароли
- Агент пишет и запускает JS-запросы к базе локально, а память регистрируется только после вашего одобрения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Obelisk читает локальные каталоги сессий ваших кодовых агентов и складывает все в одну базу `~/.obelisk/obelisk.sqlite`. В нее попадают сессии, полные тексты сообщений, вызовы инструментов, подагенты, сводки и воркфлоу. Полнотекстовый поиск по всем слоям работает через FTS5, а база обновляется, пока Obelisk следит за каталогами. Агент работает с базой через CLI `obelisk` и скилл `/obelisk`. На вопрос вроде «какие файлы мы поменяли в прошлом фиксе авторизации и зачем» агент пишет небольшой JS-запрос с функциями «search()», «sessions()», «messages()» или «sql()», запускает его локально и отвечает обычным языком. Установка CLI не требует npm-зависимостей: он использует встроенный в Node.js SQLite. Если агент пришел к выводу, который стоит сохранить, он предлагает файл памяти в формате Markdown. После вашего одобрения файл регистрируется командой `obelisk --attune`, и в следующих сессиях его можно вызвать через «memories()». Для просмотра сессий людьми есть приложение на Electron: поиск, фильтр по проекту, читаемые вызовы инструментов с диффами, статистика токенов и недельные карточки-итоги.
Для кого. Для разработчиков, которые работают сразу с несколькими кодовыми агентами и хотят находить решения и причины правок в прошлых сессиях.
Подходит, если
- Нужно вспомнить, какие файлы агент менял в прошлом исправлении ошибки и почему он так решил
- Хотите узнать, в каких сессиях один и тот же файл правили снова и снова
- Надо собрать неудачные вызовы инструментов за последнее время и увидеть, в каких задачах они случились
- После ревью-воркфлоу нужны выводы каждого подагента в одном месте
- В конце недели хочется получить итоговые карточки по сессиям командой `/obelisk recap this week`
Не подходит, если
- Ваш агент не входит в список провайдеров: индексируются только перечисленные в проекте
- Нужна память, которая сама подмешивается в каждую сессию: Obelisk отвечает на запросы агента и сам ничего в сессии не вставляет
- На машине стоит Node.js старше 22.13: CLI использует встроенный SQLite и на старых версиях не запустится
- Вам нужен общий доступ команды к истории: индекс собирается из локальных каталогов и лежит на вашей машине
Пример запроса к агенту
/obelisk найди сессии, где мы правили файл src/auth.ts, и объясни, почему менялась логика обновления токенаОграничения
Нужен Node.js 22.13 или новее. Готовые сборки приложения есть для macOS и Linux amd64 с обновлениями внутри программы, на macOS, Windows и Linux его можно запустить из исходников. Пока приложение запущено, только оно пишет в индекс, а CLI работает на чтение.
Первая индексация сотни сессий занимает около пяти секунд, дальше индекс пересобирается частями. Из OpenCode читаются версии V1 и V2 на SQLite, более ранние форматы JSON не индексируются. У Claude Code источник не подтверждает откат и текущую ветку, поэтому замененная история там не отделяется.
Индекс хранит полный текст сообщений и вызовов инструментов, в том числе то, что вы вставляли в сессии. Ограничьте доступ к файлу базы в домашнем каталоге. Лицензия AGPL-3.0. API OpenAI и Anthropic из России недоступны, но сам Obelisk работает с файлами на диске.
Как отключить. Удалите CLI командой `npm uninstall --global @obelisk-apps/cli`, уберите скилл `/obelisk` из каталога скиллов агента и при желании удалите каталог `~/.obelisk` вместе с базой.
Частые вопросы
Как поставить Obelisk для Claude Code?
Выполните `npm install --global @obelisk-apps/cli`, проверьте `obelisk --version`, затем `obelisk install`: команда поставит скилл через стандартный установщик. После этого в сессии пишите `/obelisk` и вопрос. Можно дать агенту ссылку на SKILL.md из репозитория, и он сам проведет установку, спрашивая согласие перед каждым изменением.
Какие агенты поддерживаются?
Claude Code, Codex, GitHub Copilot (данные VS Code), DeepSeek Harness, Hermes Agent, Kiro, Kimi Code, OMP, OpenCode, Pi и ZCode. Все индексируются в одну схему, а идентификаторы не-Claude сессий получают префикс провайдера, чтобы не пересекаться.
Что такое слой памяти в Obelisk?
Когда запрос к истории приводит к выводу, агент предлагает файл памяти в Markdown. После вашего одобрения он регистрируется командой `obelisk --attune`, и в будущих сессиях его возвращает «memories()». Память служит кэшем выводов и не заменяет первичные записи сессий.
Чем Obelisk отличается от Claude-Mem?
Claude-Mem сохраняет наблюдения и подставляет контекст в новые сессии. Obelisk ничего не подставляет сам: он индексирует готовую историю нескольких агентов, и агент выполняет по ней запросы, когда вы спрашиваете.
Нужно ли ставить приложение?
Нет. Для работы агента хватает CLI и скилла. Приложение нужно, чтобы вручную листать сессии, управлять памятью, смотреть тепловую карту активности и недельные карточки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и TUI для поиска по локальной истории сессий Claude Code, Codex, Cursor, Gemini CLI и других агентов, с режимом --robot для самих агентов
Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
CLI записывает историю сессий Claude Code, Cursor, Codex и других агентов в одном формате и превращает проверенные уроки в память для следующих сессий
Скилл для обмена сообщениями между Claude Code, Codex, Gemini CLI и другими консольными агентами через общую локальную базу SQLite на bash
CLI для мгновенного поиска по истории сессий кодинг-агентов на вашей машине, как git blame для сессий
Переносимая папка .agent с памятью, скиллами и протоколами, которая подключается к разным кодовым агентам и не теряет знания при смене инструмента
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Obelisk (эта запись) | нет | 700 | ||
| Claude-Mem | нет | 104 106 | сохраняет наблюдения и подставляет контекст в новые сессии, а Obelisk отвечает на запросы по уже готовой истории | |
| Beacon | нет | 2 921 | записывает историю сессий в единый формат и превращает проверенные уроки в память | |
| marm-memory | нет | не нужна | 424 | локальный MCP-сервер памяти с индексом кодовой базы и графом понятий; поиска по сессиям разных агентов в нем нет |
Коротко о README
Проект предлагает две стороны одной базы: CLI со скиллом для агентов и десктопное приложение для людей. В описании приведены примеры вопросов к `/obelisk`, схема работы запроса, таблица слоев индекса и перечень провайдеров с путями к их данным по умолчанию. Отдельно разобраны память, недельный итог и поддержка замененной истории для Pi, OMP, ZCode, OpenCode и других. Нестандартные каталоги задаются в настройках приложения.