🎨 Interfaz de Terminal y Control de Sesión

Esta sección cubre todos los comandos interactivos enfocados en personalizar, auditar e interactuar con la consola de comandos interactiva de Context Code en tiempo real.

---

🎨 /color (Color del Agente)

Permite personalizar la apariencia visual de la CLI cambiando el color distintivo asignado al agente.

• Sintaxis:

  /color <nombre_color>

• Colores sugeridos: cyan, magenta, green, yellow, blue, red.
• Caso de uso: Ideal para diferenciar rápidamente terminales activas si estás trabajando con múltiples repositorios o perfiles al mismo tiempo.

---

🧹 /clear (Limpieza de Pantalla y Memoria)

Limpia la pantalla física de la terminal y vacía por completo el historial de conversación del búfer del modelo.

• Sintaxis:

  /clear

• Detalle técnico: A diferencia de un comando clear clásico del sistema operativo, /clear borra la memoria del contexto activo enviado al LLM. Si sientes que la conversación se ha desviado o deseas arrancar una tarea totalmente nueva en el mismo directorio, corre /clear para resetear el historial y ahorrar tokens de entrada.

---

📦 /compact (Compresión Inteligente de Contexto)

Reduce el tamaño del historial acumulado de turnos de conversación para liberar espacio en el contexto de tokens del modelo.

• Sintaxis:

  /compact

• Detalle técnico: A medida que la sesión avanza, el historial de parches y salidas de herramientas consume gran parte de la ventana de contexto. /compact reemplaza los mensajes detallados más antiguos por resúmenes compactos que mantienen la esencia de lo realizado, liberando hasta un 60% de tokens del buffer sin que el agente pierda el hilo del trabajo anterior.

---

📋 /copy (Copiar al Portapapeles)

Copia de forma directa y limpia el último mensaje largo de texto generado por el agente al portapapeles del sistema operativo.

• Sintaxis:

  /copy

• Caso de uso: Sumamente útil para extraer fragmentos de explicaciones, documentación o configuraciones extensas redactadas por el agente sin necesidad de seleccionarlas manualmente con el ratón de la terminal.

---

🎹 /keybindings (Atajos de Teclado)

Abre un menú visual interactivo en Ink para configurar y editar las combinaciones de teclas asignadas a las funciones del TUI.

• Sintaxis:

  /keybindings

• Atajos por defecto:
  • Meta + M (o Alt + M): Alterna la confirmación automática de parches de archivos.
  • Esc: Interrumpe la ejecución del agente o llamada de red activa.

---

🎭 /theme (Temas de Consola)

Permite alternar entre los diferentes perfiles estéticos preinstalados para la consola de Context Code.

• Sintaxis:

  /theme <nombre_tema>

• Temas disponibles: dark, light, solarized, cyberpunk, monokai.

---

🧭 /statusline (Barra de Estado)

Alterna la visualización de la barra inferior de estado (footer) que muestra detalles clave sobre la sesión activa.

• Sintaxis:

  /statusline

• Información mostrada: Modelo activo, coste de sesión en USD, estado de bridges de red (WA/TG) y temporizadores.

---

⌨️ /vim (Navegación Interactiva Vim)

Activa o desactiva la navegación interactiva por la consola y el historial utilizando atajos de teclado y comandos de navegación clásicos del editor Vim.

• Sintaxis:

  /vim

• Teclas asignadas: h, j, k, l para navegar líneas e inputs, y controles de edición rápida.

---

🏷️ /stickers (Decoración Visual)

Permite configurar o alternar la decoración gráfica y stickers integrados en la terminal.

• Sintaxis:

  /stickers

---

📝 /btw (Nota Rápida en Búfer)

Añade una nota rápida ("By The Way") directamente en el buffer de contexto de la sesión actual sin esperar una evaluación completa del modelo.

• Sintaxis:

  /btw <contenido_de_la_nota>

• Caso de uso: Añadir una aclaración técnica sobre la marcha antes de que el agente comience un ciclo autónomo largo de /objetivo.

---

🕒 /timeline (Línea Temporal de Ejecuciones)

Muestra una línea temporal gráfica de todos los turnos, parches y herramientas ejecutadas durante la sesión de desarrollo activa.

• Sintaxis:

  /timeline

---

🚀 Configuración Inicial y Lanzamiento

📥 /install (Instalar Lanzador Local)

Instala el lanzador context en ~/.local/bin/ (Linux/macOS) o %USERPROFILE%\.local\bin\context.cmd (Windows) para poder ejecutar Context Code desde cualquier carpeta sin invocar Node directamente (alias: /instalar).

• Sintaxis:

  /install

• Comportamiento:
  • Windows: genera context.cmd que detecta node.exe por PATH o process.execPath, fija MAX_THINKING_TOKENS=0 si no está definida y lanza el CLI compilado en dist/src/entrypoints/cli.js.
  • Linux/macOS: crea un script POSIX en ~/.local/bin/context con permisos chmod +x.
• Caso de uso: después de hacer pnpm build por primera vez, ejecuta /install para tener el binario context disponible globalmente.

📚 /iniciar (Documentar la Base de Código en .context/CONTEXT.md)

Analiza tu proyecto y crea (o actualiza) .context/CONTEXT.md, el archivo de contexto persistente que el agente carga al inicio de cada sesión. Es el equivalente local de CLAUDE.md para esta CLI.

• Sintaxis:

  /iniciar

• Comportamiento extendido (USER_TYPE=ant o CONTEXT_CODE_NEW_INIT=1): además del CONTEXT.md, propone crear habilidades opcionales y ganchos (hooks/) basados en patrones detectados.
• Idioma: todo el flujo se ejecuta y responde en español por diseño — el prompt fuerza formulaciones como "Voy a revisar la base de código...".
• Efecto secundario: marca el onboarding del proyecto como completo (maybeMarkProjectOnboardingComplete).

🖥️ /terminal-setup (Atajos del Terminal)

Instala los atajos de teclado del terminal para mejorar la experiencia interactiva (alias: /configurar-terminal). El comportamiento exacto depende de tu terminal:

• Apple Terminal: habilita Option+Enter para nuevas líneas y campana visual.
• Otros (xterm, GNOME, Windows Terminal): instala el atajo Shift+Enter para nuevas líneas multilinea.
• Sintaxis:

  /terminal-setup

• Auto-oculto: si tu terminal ya soporta el protocolo CSI u / Kitty Keyboard nativamente (Ghostty, Kitty, iTerm2, WezTerm), el comando queda oculto del menú porque no es necesario.

🆔 /version (Versión en Ejecución)

Imprime la versión de Context Code que efectivamente está corriendo en esta sesión — no la última que descargó la auto-actualización. Útil para distinguir entre lo instalado vs lo activo. Soporta ejecución no interactiva.

• Sintaxis:

  /version

• Salida: <VERSION> o <VERSION> (compilado el <BUILD_TIME>) cuando el bundle incluye timestamp.
• Disponibilidad: solo USER_TYPE=ant (interno Anthropic). Para usuarios externos, usa context --version desde la shell o /upgrade para ver versiones disponibles.

📨 /feedback (Reportar un Bug)

Envía feedback o reporte de bug sobre Context Code (alias: /bug). Comando oculto del menú. Solo aparece si se cumplen todas estas condiciones: no usas Bedrock/Vertex/Foundry, no estás en modo "essential traffic only", no eres USER_TYPE=ant, y la policy allow_product_feedback está habilitada para tu organización.

• Sintaxis:

  /feedback
  /feedback report     # modo informe formal con plantilla

• Variables de bypass: DISABLE_FEEDBACK_COMMAND=1 o DISABLE_BUG_COMMAND=1 desactivan el comando incluso si las demás condiciones se cumplen — útil para empresas que prefieren canalizar feedback por su propio helpdesk.