Documentación de Cocxy Terminal

Requiere macOS 14.0 Sonoma o posterior, Apple Silicon o Intel, y cerca de 60 MB de espacio en disco. Instala con brew tap salp2403/tap && brew install --cask cocxy, o descarga el DMG firmado desde GitHub Releases. Al abrir por primera vez, Cocxy crea ~/.config/cocxy/ con valores locales y seguros.

Para actualizar desde Homebrew usa brew update && brew upgrade --cask cocxy. Si instalas por DMG, arrastra Cocxy Terminal a /Applications; si macOS muestra un aviso inicial, usa clic derecho y Abrir.

La interfaz principal se organiza alrededor de la barra Aurora, pestañas verticales, divisiones, paleta de comandos, panel de agentes, navegador integrado y Preferencias. Las capturas de la guía inglesa usan imágenes reales del paquete de la app para mostrar barra lateral, panel de agentes, divisiones, navegador, comandos y ajustes; esta guía mantiene las mismas superficies cubiertas en español.

Un espacio agrupa sesiones por proyecto. Cada pestaña tiene su propia terminal, directorio, rama Git, estado de agente y paneles asociados. Las divisiones permiten combinar terminal, navegador, Markdown, remoto o revisión de código sin salir de la ventana.

Sin telemetría: Cocxy no envía analíticas, rastreo ni reportes automáticos de fallos. Las sesiones, notas, perfiles, plugins, copias de seguridad y configuración permanecen locales salvo que ejecutes una herramienta externa de forma explícita.

La configuración vive en ~/.config/cocxy/config.toml. Puedes ajustar shell, directorio inicial, tema, fuente, tamaño, cursor, scrollback, copiar al seleccionar, protección de pegado, idioma, pestañas, divisiones, detección de agentes, notificaciones y terminal rápida.

Los cambios válidos se recargan de forma conservadora. Valores fuera de rango se normalizan cuando es seguro hacerlo; si el TOML está roto, corrige el archivo y vuelve a guardar.

Los atajos principales son Cmd+T para nueva pestaña, Cmd+W para cerrar, Cmd+D para dividir, Cmd+Shift+P para la paleta, Cmd+F para buscar y Esc para cerrar paneles superpuestos. El editor de atajos en Preferencias permite reasignar acciones y bloquea conflictos antes de guardar.

Cocxy no incluye SDKs de analíticas ni subida automática de reportes de fallos. La verificación de actualizaciones usa el appcast firmado de Cocxy. GitHub CLI, SSH, bases de datos, nube, proveedores remotos o cualquier otra red se ejecutan solo cuando tú lo configuras y disparas.

Los flujos comunes combinan terminal local, panel de agente, revisión de código, Markdown, navegador, remoto, plugins y CLI local. La paleta de comandos es el punto de entrada rápido para abrir paneles, cambiar tema, saltar a sesiones y ejecutar acciones.

Cocxy detecta agentes de código mediante hooks locales, secuencias OSC, patrones de salida y heurísticas de tiempo. Ejecuta cocxy setup-hooks para configurar integraciones compatibles instaladas localmente. Los perfiles personalizados viven en ~/.config/cocxy/agents.toml.

Los estados visibles son inactivo, lanzando, trabajando, esperando entrada, terminado y error. La detección se evalúa sobre salida local ya renderizada; no intercepta tráfico ni sube contenido.

El panel de revisión muestra archivos modificados por una sesión de agente, diffs, fragmentos, comentarios en línea, estadísticas y acciones para aceptar o revertir cambios de forma granular. Ábrelo con Cmd+Option+R o cocxy review.

Cuando envías comentarios, Cocxy los formatea y los entrega por la PTY de la sesión original. Las operaciones Git usan el repositorio local y mantienen guardas contra rutas inseguras.

El panel Markdown ofrece editor, previsualización, modo dividido, tabla de contenido, avisos, notas al pie, Mermaid, KaTeX, resaltado de sintaxis, exportación HTML/PDF y manejo sin red de adjuntos. El texto fuente y la previsualización comparten tema legible con la app.

Los notebooks de Cocxy usan QuickLook para previsualizar contenido local sin red. El generador evita cargas remotas y mantiene los recursos necesarios dentro del archivo o del paquete de la app.

El navegador sirve para revisar servidores locales, documentación y apps web junto a la terminal. Incluye perfiles aislados, favoritos, descargas, búsqueda en página, herramientas de desarrollo e indicadores de puertos para saltar a servicios detectados sin cambiar de app.

Espacios remotos usa OpenSSH, perfiles locales, Keychain opcional, ControlMaster, túneles, SFTP, tmux y daemon local opcional. Los perfiles y llaves se gestionan desde Preferencias o el panel remoto; Cocxy no guarda credenciales nuevas de terceros por su cuenta.

cocxy web-start --port 8080 expone la terminal activa en un servidor local para programación en pareja, asistencia o paneles internos. Usa cocxy web-status y cocxy web-stop para controlar el ciclo de vida.

La integración de shell emite marcadores OSC para directorio, límites de comando, bloques y estado. Funciona con zsh, bash y fish conservando configuración existente. Si necesitas diagnosticarlo, revisa cocxy status y cocxy core-modes.

Un archivo .cocxy.toml dentro del repositorio puede ajustar fuente, opacidad, patrones extra de agentes, atajos y opciones de espacio solo para ese proyecto. Cocxy lo detecta al cambiar de directorio y aplica sobrescrituras sin reiniciar.

Cocxy expone comandos para crear pestañas, ejecutar texto, dividir terminales, enfocar pestañas, cerrar y leer estado desde automatizaciones de macOS. También ofrece acciones para Atajos con ejecución local.

Los plugins viven en ~/.config/cocxy/plugins/ o dentro del proyecto. Responden a eventos como inicio de sesión, agente detectado, cambio de estado, comando completado, pestaña creada, pestaña cerrada y cambio de directorio. Se ejecutan con sandbox, tiempo límite y permisos explícitos.

Divide una pestaña con Cmd+D o Cmd+Shift+D. Cada división puede alojar una terminal o un panel. La app protege el último terminal activo y permite navegar entre panes con atajos.

La terminal rápida muestra una terminal desplegable con Cmd+`. Se configura en [quick-terminal] con posición, alto, atajo y comportamiento al perder foco.

Cocxy muestra insignias por pestaña, insignia en el Dock, notificaciones de macOS, panel de historial y ruteo inteligente para saltar a la sesión que requiere atención. Todo se controla desde Preferencias y se puede desactivar.

Presiona Cmd+Shift+P para buscar acciones, abrir paneles, cambiar tema, navegar a pestañas, ejecutar herramientas y revisar atajos. La paleta respeta el idioma seleccionado y las reasignaciones de atajos.

Las sesiones guardan pestañas, directorios, divisiones, paneles y estado del espacio. La restauración al iniciar y la recuperación de fallos usan instantáneas locales; si hubo cierre inesperado, Cocxy ofrece restaurar o mantener la sesión actual.

Cocxy crea copias locales en ~/Library/Backups/Cocxy con ajustes, notebooks, flujos, habilidades personalizadas, notas, fragmentos, temas y metadatos SSH cifrados cuando esas fuentes existen. Nada se sube a un servicio externo.

Abre Preferencias > Backups, usa Actualizar, elige una copia y selecciona un artefacto. Restaura solo el artefacto seleccionado; los demás archivos locales permanecen intactos.

Para migrar a otra Mac, copia la carpeta de backups, configura esa ruta en Preferencias y restaura solo los artefactos que quieras conservar. Cocxy bloquea la restauración manual si hay cambios de preferencias sin guardar.

El binario cocxy controla pestañas, ventanas, divisiones, sesión, paneles, plugins, remoto, Markdown, historial, estado y diagnósticos mediante un Unix Domain Socket local con permisos por usuario. Prueba cocxy status, cocxy new-tab, cocxy list-tabs, cocxy review, cocxy setup-hooks y cocxy help.

Cocxy incluye temas oscuros y claros y permite agregar TOML de tema en ~/.config/cocxy/themes/. Puedes configurar par claro/oscuro para seguir la apariencia de macOS y recargar sin recrear superficies de terminal.

agents.toml define display-name, soporte OSC, patrones de lanzamiento, patrones de espera, errores, indicadores de finalización y tiempos límite por agente. Usa cadenas TOML con comillas simples para regex con barras inversas, por ejemplo '^my-agent\\b'.

Antes de actualizar, revisa Versiones y mantén una copia de ~/.config/cocxy/ si usas perfiles SSH, fragmentos, temas, plugins, datos del navegador o espacios guardados. Las migraciones preservan TOML válido y agregan valores predeterminados solo cuando hacen falta para mantener un flujo existente.

cp -R ~/.config/cocxy ~/Desktop/cocxy-config-backup crea una copia rápida antes de brew update && brew upgrade --cask cocxy.

Si una preferencia no cambia, revisa que config.toml sea TOML válido. Si Homebrew no ve una versión nueva, ejecuta brew update. Si la detección de agentes no aparece, confirma [agent-detection] enabled = true y regenera agents.toml si fue editado a mano.

Para restablecer, cierra Cocxy y elimina ~/.config/cocxy/. Esto borra perfiles, favoritos, plugins, fragmentos y datos locales guardados ahí, así que crea una copia primero si quieres conservarlos.