OpenHandoff

Переносимые, локально-ориентированные передачи контекста между ИИ-агентами кодирования.

OpenHandoff хранит постоянную информацию о проекте в двух небольших файлах:

• CONTEXT.md для людей и Obsidian;

• context.json для агентов, MCP-адаптеров и автоматизации.

Первый MVP намеренно простой и проверяемый: без облачного аккаунта, без скрытой базы данных, а редактирование происходит до записи передачи. Будущие адаптеры смогут читать транскрипты Codex, Claude Code, Cursor и Windsurf, не навязывая специфический для вендора формат памяти.

OpenHandoff предназначен для публичных репозиториев и командных передач: файлы — это обычный текст, MCP-сервер не имеет зависимостей, а значения, похожие на секреты, редактируются перед сохранением.

Набор навыков

Репозиторий включает три переносимых навыка в skills/:

• openhandoff-context — захват, восстановление и упаковка контекста между агентами.

• openhandoff-privacy — аудит передач и транскриптов перед их публикацией.

• openhandoff-release — подготовка протестированных, документированных и воспроизводимых релизов.

Скопируйте каталог навыка в ваш каталог навыков Codex или установите его с помощью установщика навыков Codex, используя этот репозиторий GitHub. Навыки намеренно узкие, чтобы их можно было использовать независимо.

Related MCP server: ai-cortex

Быстрый старт

python -m venv .venv
source .venv/bin/activate
pip install -e .
openhandoff init .context --title "My project"
openhandoff capture .context \
  --title "My project" \
  --decision "Use SQLite" \
  --todo "Add the MCP adapter" \
  --notes "The next agent should run the test suite first."
openhandoff show .context

Для обычной установки используйте pipx install openhandoff после публикации релиза. Зависимости для разработки и проверки описаны в CONTRIBUTING.md.

Создайте компактный срез контекста для конкретной задачи. Сначала сохраняются соответствующие решения, TODO и строки заметок, затем результат детерминированно обрезается до запрошенного бюджета:

openhandoff pack .context --task "MCP adapter" --max-chars 4000

MCP-сервер

MCP-сервер без зависимостей предоставляет load_handoff, save_checkpoint, search_handoff и pack_context через stdio:

openhandoff-mcp

Для локальной конфигурации агента используйте команду openhandoff-mcp без доступа к сети. Сервер только читает и записывает путь передачи, указанный агентом.

Пример конфигурации Codex:

[mcp_servers.openhandoff]
command = "openhandoff-mcp"
args = []

Пример конфигурации Claude Desktop:

{
  "mcpServers": {
    "openhandoff": {
      "command": "openhandoff-mcp",
      "args": []
    }
  }
}

Захват событий агента

openhandoff-hook принимает JSON-событие (или обычный текст) на stdin, редактирует значения, похожие на учетные данные, и добавляет результат в .context/events.jsonl:

printf '%s\n' '{"type":"agent_message","message":"finished"}' \
  | openhandoff-hook --path .context

Codex может отправлять свой notify-полезный груз напрямую в хук. Добавьте это в вашу конфигурацию Codex (команда получает JSON-полезный груз на stdin):

notify = ["openhandoff-hook", "--path", ".context"]

Для Claude Code подключите тот же исполняемый файл к командному хуку в ваших настройках. Точный файл настроек может различаться в зависимости от версии Claude Code; это иллюстративный пример:

{
  "hooks": {
    "afterTurn": [
      {"command": "openhandoff-hook --path .context"}
    ]
  }
}

Импорт транскрипта

Потоки событий JSONL от Codex и Claude Code можно импортировать в тот же формат:

openhandoff import-transcript ./rollout.jsonl .context --title "Project handoff"

Дорожная карта

1. Адаптеры транскриптов Cursor и Windsurf.

2. Цитирование файлов и коммитов в контекстных пакетах для конкретных задач.

3. Синхронизация Obsidian и GitHub со сканированием секретов и контрольными точками ревью.

Состояние проекта

• Лицензия: MIT; см. LICENSE.

• Сообщение о безопасности: см. SECURITY.md.

• Вклад: см. CONTRIBUTING.md.

• Примечания к релизам: см. CHANGELOG.md.

• Архитектура: см. docs/architecture.md.

• Процесс релиза: см. docs/releasing.md.

Проект находится на ранней стадии и приветствует реальные отзывы, интеграции и улучшения документации. Пожалуйста, не коммитьте чат-транскрипты, учетные данные или личные данные Obsidian.