ctx

ctx (автор dchu917) - это локальный менеджер контекста для Claude Code и Codex. Он позволяет сохранять контекст диалога в именованные workstream'ы, чисто возобновлять их между сессиями и ветвиться от сохранённого состояния без утечки будущих изменений обратно в исходную ветку. Всё состояние хранится в локальной базе данных SQLite - никаких API-ключей и сторонних сервисов.

Написан на Python, лицензия MIT, 68 звёзд, создан 13 апреля 2026 года.

Что решает

Штатная работа с диалогами в Claude Code и Codex страдает двумя хроническими проблемами:

1. Дрейф транскриптов. При возобновлении "последней сессии" может подхватиться более свежий диалог из того же репозитория, из-за чего теряется исходная нить.
2. Нет чистого ветвления. Чтобы начать параллельную ветку работы из текущего состояния, приходится либо дублировать весь транскрипт целиком, либо терять историю.

ctx решает обе проблемы, привязывая каждый workstream к точным ID диалогов Claude и/или Codex, из которых он был получен. Последующие выгрузки (pull) остаются в рамках этого диалога, а не перескакивают на самый свежий чат на диске. Ветвление создаёт новый workstream на базе сохранённого состояния другого, не разделяя с ним будущие обновления транскрипта.

Модель workstream'ов

Claude Code chat          Codex chat
      |                      |
      v                      v
   /ctx ...               ctx ...
          \              /
           v            v
      +----------------------+
      | workstream: feature-audit |
      |   claude:  abc123    |
      |   codex:   def456    |
      +----------------------+
                 |
                 +--> feature-audit-v2 branch

Каждый workstream привязан к репозиторию и ссылается на ноль или более связанных ID диалогов для каждого провайдера. Записи (полученные через --pull) индексируются для поиска. Курирование встроено на базовом уровне: сохранённые записи можно закреплять (pin), чтобы они всегда загружались при возобновлении, исключать (exclude), чтобы они оставались доступными для поиска, но больше не передавались модели, или удалять насовсем.

Использование

Из Claude Code (слеш-команды):

• /ctx start feature-audit --pull - создать workstream и выгрузить в него текущий диалог.
• /ctx resume feature-audit - продолжить существующий workstream, добавив новый контекст.
• /ctx branch feature-audit feature-audit-v2 - создать новый workstream на основе текущего сохранённого состояния другого.
• /ctx search dataset download - поиск по сохранённым workstream'ам и записям.
• /ctx curate my-stream - открыть интерфейс для курирования контекста.

Из Codex (CLI - Codex не поддерживает определённые в репозитории слеш-команды):

• ctx start my-stream --pull
• ctx resume my-stream --compress (для уменьшения объёма загружаемого контекста)
• ctx list --this-repo, ctx search ... --this-repo
• ctx web --open - локальный веб-интерфейс в браузере для просмотра, поиска и копирования команд продолжения.

Варианты установки

• git clone && ./setup.sh - локальная БД SQLite проекта в ./.contextfun/context.db, симлинки на skill в ~/.claude/skills и ~/.codex/skills.
• ./setup.sh --global - закреплённый глобальный релиз в ~/.contextfun.
• Установочный скрипт curl | bash для глобальной установки без клонирования.
• npx skills add только для bootstrap-skill'а.
• Загрузка в shell через source <(curl ... agent_bootstrap.sh).

Место в экосистеме

Это инструмент организации рабочего процесса в инфраструктуре LLM-агентов, в отличие от:

• hazmat - песочницы для изоляции доступа агента к ОС
• bubblewrap-dev-env - аналог песочницы для Linux
• crabtrap - применение политик на уровне HTTP
• charlie-daemons - автономные фоновые агенты

ctx ориентирован на сессии агентов под управлением пользователя - он помогает человеку разделять несколько параллельных потоков работы с агентом и легко к ним возвращаться. Это решает задачу продуктивности, а не безопасности.

Идея с привязкой диалогов - ключевая несущая конструкция всей архитектуры: и Claude Code, и Codex сохраняют транскрипты на диск без надёжного идентификатора вида "это именно тот диалог, который имелся в виду". Поэтому контекст-менеджер, определяющий сессию по "самому свежему транскрипту", принципиально хрупок. Привязка к явным ID диалогов делает логику возобновления надёжной.

Репозиторий

https://github.com/dchu917/ctx - 68 звёзд, MIT, Python. Документация в репозитории.

Связанные страницы

• botctl - менеджер процессов для долгоживущих автономных агентов Claude (смежная, но другая задача: ctx предназначен для интерактивных сессий, а botctl - для автономных)
• bubblewrap-dev-env, hazmat, crabtrap, charlie-daemons - остальной стек инфраструктуры LLM-агентов
• context-engineering - более широкая концепция сбора необходимого предшествующего состояния в контекст LLM