ctx (ActiveMemory) CLI
ctx
Файловая система контекста хранит задачи, решения и выводы проекта между сессиями, чтобы агент не начинал с нуля.
- 79 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструмент пишет файлы в `.context/`, а хук агента выполняет команду перед каждым вызовом инструмента.
Установка
- Работает в
Ручная установка
git clone https://github.com/ActiveMemory/ctx.git && cd ctx && CGO_ENABLED=0 go build -o ctx ./cmd/ctxСборка из исходников, второй вариант из README. Первый вариант: готовые бинарные файлы на странице релизов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент пишет файлы в `.context/`, а хук агента выполняет команду перед каждым вызовом инструмента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`ctx` ведет в проекте каталог `.context/`, где копятся задачи, решения с обоснованием и накопленные уроки. Агент в начале сессии получает из него готовый пакет контекста командой `ctx agent --budget 4000`, а не спрашивает все заново. Хук `PreToolUse` для Claude Code подтягивает этот пакет автоматически. Работа идет через обычную командную строку: `ctx task add`, `ctx decision add`, `ctx learning add`, `ctx status`. Для исследовательской работы `ctx init` дополнительно разворачивает редакторский конвейер базы знаний с командами `/ctx-kb-ingest` и `/ctx-kb-ask` и записями передачи между сессиями. Инструмент читает только файлы, поэтому подходит любому ассистенту, который умеет их читать.
Для кого. Разработчикам, которые ведут долгий проект с агентом и устали пересказывать архитектуру в каждой новой сессии.
Подходит, если
- Агент забывает принятые решения, и они раз за разом обсуждаются заново.
- Над проектом работают разные ассистенты, а контекст нужен общий.
- Исследование идет неделями, и результаты нужно складывать в базу знаний со ссылками на источники.
- Между сессиями требуется короткая запись передачи: что сделано и что делать дальше.
Не подходит, если
- Проект однодневный, и хватает файла `CLAUDE.md` с несколькими правилами.
- Репозитория git нет, а `ctx` без `.git/` отказывается работать.
- Нужны только правила стиля для агента без истории решений и задач.
Пример запроса к агенту
Загрузи пакет контекста проекта, напомни принятые решения по базе данных и добавь задачу про миграцию в `ctx`.Ограничения
Перед `ctx init` нужен репозиторий git: без `.git/` команда отказывается работать. Команды читают `$PWD/.context/`, поэтому запускайте их из корня проекта, а переменной окружения и поиска вверх по каталогам нет. Установка идет из готовых бинарных файлов на странице релизов или сборкой на Go. Подключение к Claude Code, Codex, OpenCode, Pi, Cursor и Aider описано в документации на ctx.ist, а не в README. Лицензия Apache 2.0 указана в тексте README.
Как отключить. Удалите хук и плагин из настроек агента и бинарный файл `ctx`. Каталог `.context/` с накопленными записями оставьте или удалите вручную.
Частые вопросы
Как установить ctx?
Скачайте готовый бинарный файл со страницы релизов репозитория или соберите из исходников: `git clone https://github.com/ActiveMemory/ctx.git`, затем `CGO_ENABLED=0 go build -o ctx ./cmd/ctx` в папке проекта.
С чего начать в проекте?
Выполните `ctx init` в корне репозитория, затем `ctx status`. Первую запись добавляет `ctx task add`, а пакет для агента собирает `ctx agent --budget 4000`.
Какие записи хранит ctx?
Задачи, решения с контекстом, обоснованием и последствиями (`ctx decision add`) и уроки (`ctx learning add`). Для баз знаний есть темы и записи передачи.
Привязан ли ctx к одному агенту?
Нет. Инструмент работает с любым ассистентом, который читает файлы, а интеграции описаны для Claude Code, Codex, OpenCode, Pi, Cursor и Aider.
Чем база знаний отличается от задач и решений?
Это отдельный конвейер для исследований: `ctx kb topic new` создает страницу темы, `/ctx-kb-ingest` вносит источник, а `/ctx-kb-ask` отвечает только по базе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыContextLattice — локальный слой контекста для агентов
ContextLattice
Локальный слой памяти: цель, решения и доказательства сессии собираются в короткий пакет, который агент открывает заново
Шаблон CLAUDE.md из 7 правил и команды передачи сессий, чтобы Claude Code не терял числа и решения при сжатии контекста
hipocampus дает агенту файловую память: индекс тем на 3000 токенов грузится в каждую сессию и подсказывает, что обсуждалось раньше
UltraContext собирает сессии Claude Code, Codex и OpenClaw в одном месте, чтобы агенты видели контекст друг друга.
Память для агентов: сессия из Claude Code продолжается в Codex с теми же решениями и открытыми задачами.
Agentic Substrate
Agentic Substrate (claude-user-memory)
Короткий обратимый набор правил для агента: исследуй неясное, планируй соразмерно, проверяй результат и храни выверенные знания
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ctx (ActiveMemory) (эта карточка) | нет | 79 | |
| agent-memory | нет | 4 315 | память агента другого автора; здесь решения и задачи лежат файлами в проекте, плюс конвейер базы знаний |
| ctx | нет | 1 181 | одноименная карточка про другой проект ctxrs; здесь инструмент ActiveMemory с каталогом `.context/` |
Коротко о README
README излагает идею контекста как состояния, показывает пример диалога агента с памятью и перечисляет шаги установки и быстрого старта. Подробности и рецепты вынесены на сайт ctx.ist.