ctx

Active · v1.6.3

🧩 Sobre este proyecto

ctx es una herramienta CLI que preserva el contexto de sesión de Claude Code entre compactaciones.

Cuando Claude Code alcanza el límite de su ventana de contexto y compacta la conversación, información crítica se pierde o se diluye: el objetivo actual, las decisiones técnicas ya tomadas, los archivos que estabas modificando, lo que faltaba por hacer. Después de dos o tres compactaciones, Claude puede olvidar qué estabas construyendo, repetir trabajo, o contradecir decisiones ya acordadas.

ctx se engancha a los eventos PreCompact, PostCompact y SessionStart de Claude Code para capturar y restaurar un snapshot estructurado de tu contexto de trabajo, cada vez. Los snapshots están delimitados por rama, así que sesiones paralelas en ramas distintas nunca colisionan.

⚙️ Cómo usarlo

Instalar:

curl -fsSL https://raw.githubusercontent.com/AgusRdz/ctx/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/AgusRdz/ctx/main/install.ps1 | iex

Homebrew:

brew install AgusRdz/tap/ctx

Registrar los hooks:

ctx init

A partir de ahí, todo es automático.

📋 Qué captura

Campo	Qué preserva
Goal	Qué estás construyendo en este momento
Decisions	Decisiones técnicas ya tomadas en la sesión
In Progress	Archivos que se están modificando
Next	Qué hacer cuando el contexto se restaure

🛠️ Comandos principales

ctx init              # instalar hooks en Claude Code
ctx init --status     # verificar instalación
ctx show              # ver snapshot actual
ctx clear             # eliminar snapshot
ctx list              # listar proyectos con snapshots
ctx config            # mostrar configuración activa
ctx doctor            # diagnóstico de instalación
ctx logs              # ver logs de hooks
ctx agents            # modo de captura de subagentes
ctx update            # actualizar a la última versión

🔧 Detalles técnicos

Escrito en Go — rápido, binario único, sin dependencias de runtime
Multiplataforma: Linux, macOS, Windows (amd64 / arm64)
Configuración en dos capas: global (~/.config/ctx/config.yml) y por proyecto (.ctx/config.yml)
Snapshots almacenados en ~/.local/share/ctx/{project-hash}/
Compresión inteligente de transcripciones para optimizar el presupuesto de tokens
Fallback determinístico si claude -p no está disponible

💬 Lee más sobre la motivación detrás de ctx en el post del blog.