OpenHandoff

Traspasos de contexto portátiles y locales entre agentes de codificación de IA.

OpenHandoff mantiene la verdad duradera del proyecto en dos archivos pequeños:

• CONTEXT.md para personas y Obsidian;

• context.json para agentes, adaptadores MCP y automatización.

El primer MVP es deliberadamente aburrido e inspeccionable: sin cuenta en la nube, sin base de datos oculta, y la redacción ocurre antes de que se escriba el traspaso. Los adaptadores futuros podrán leer transcripciones de Codex, Claude Code, Cursor y Windsurf sin imponer un formato de memoria específico del proveedor.

OpenHandoff está diseñado para repositorios públicos y traspasos de equipo: los archivos son texto plano, el servidor MCP no tiene dependencias, y los valores con forma de secreto se redactan antes de la persistencia.

Paquete de habilidades

El repositorio incluye tres habilidades portátiles bajo skills/:

• openhandoff-context — capturar, recuperar y empaquetar contexto entre agentes.

• openhandoff-privacy — auditar traspasos y transcripciones antes de compartirlos.

• openhandoff-release — preparar lanzamientos probados, documentados y reproducibles.

Copia un directorio de habilidades en tu directorio de habilidades de Codex, o instálalo con el instalador de habilidades de Codex usando este repositorio de GitHub. Las habilidades son deliberadamente limitadas para que puedan usarse de forma independiente.

Related MCP server: ai-cortex

Inicio rápido

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

Para una instalación normal de usuario, usa pipx install openhandoff después de que se publique un lanzamiento. Las dependencias de desarrollo y las comprobaciones están documentadas en CONTRIBUTING.md.

Construye un fragmento de contexto compacto para una tarea específica. Las decisiones coincidentes, los TODOs y las líneas de notas se mantienen primero, y luego el resultado se recorta de forma determinista al presupuesto solicitado:

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

Servidor MCP

El servidor MCP sin dependencias expone load_handoff, save_checkpoint, search_handoff y pack_context a través de stdio:

openhandoff-mcp

Para una configuración de agente local, usa el comando openhandoff-mcp sin acceso a la red. El servidor solo lee y escribe la ruta de traspaso proporcionada por el agente.

Ejemplo de configuración de Codex:

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

Ejemplo de configuración de Claude Desktop:

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

Capturar eventos de agente

openhandoff-hook acepta un evento JSON (o texto plano) en stdin, redacta valores con forma de credencial y añade el resultado a .context/events.jsonl:

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

Codex puede enviar su carga útil de notify directamente al hook. Añade esto a tu configuración de Codex (el comando recibe la carga útil JSON en stdin):

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

Para Claude Code, conecta el mismo ejecutable al hook de comandos en tu configuración. El archivo de configuración exacto puede variar según la versión de Claude Code; este es un ejemplo ilustrativo:

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

Importar una transcripción

Las secuencias de eventos JSONL de Codex y Claude Code se pueden importar al mismo formato:

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

Hoja de ruta

1. Adaptadores de transcripción para Cursor y Windsurf.

2. Citas de archivos y commits en paquetes de contexto específicos de tareas.

3. Sincronización con Obsidian y GitHub con escaneo de secretos y puertas de revisión.

Salud del proyecto

• Licencia: MIT; ver LICENSE.

• Reporte de seguridad: ver SECURITY.md.

• Contribuciones: ver CONTRIBUTING.md.

• Notas de lanzamiento: ver CHANGELOG.md.

• Arquitectura: ver docs/architecture.md.

• Proceso de lanzamiento: ver docs/releasing.md.

El proyecto está en una etapa temprana y agradece comentarios del mundo real, integraciones y mejoras de documentación. Por favor, no comprometas transcripciones de chat, credenciales ni datos privados de Obsidian.