Skip to content

🚀 Comandos Avanzados y Experimentales

En esta sección se detalla el comportamiento, la sintaxis y los casos de uso del catálogo de comandos avanzados, experimentales e internos que están mapeados en el código de Context Code (CLI/src/commands.ts).


🛡️ Seguridad y Control de Sesión

🔑 /permissions (Reglas de Herramientas)

Abre un menú interactivo para gestionar reglas de permisos que permiten o deniegan herramientas automáticamente, sin pedir confirmación al usuario en cada uso (alias: /allowed-tools, /permisos).

  • Sintaxis:
    text
    /permissions
  • Detalle técnico: las reglas se persisten en SQLite (provider-state.sqlite3, tabla permission_rules) y se aplican antes de que cualquier herramienta se ejecute. Cada regla combina herramienta + patrón + comportamiento (allow / deny / ask). Por ejemplo, puedes permitir todo Bash(npm test*) pero denegar Bash(rm -rf*).
  • Caso de uso: entornos no interactivos (CI, agentes desatendidos) donde no hay nadie para responder los diálogos de permiso. Define reglas estrictas y deja al agente trabajar.

🔒 /privacy-settings (Privacidad y Telemetría)

Panel de privacidad para suscriptores Consumer de Claude.ai (alias: /privacidad, /ajustes-privacidad). Solo aparece si tu cuenta es Consumer; está oculto para cuentas API/Console.

  • Sintaxis:
    text
    /privacy-settings
  • Opciones disponibles: desactivar el envío de transcripciones de entrenamiento, alternar telemetría anónima y revisar a qué datos accede Context Code en tu nombre.
  • Alternativa para todos los usuarios: las variables DISABLE_TELEMETRY=1 y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 en ~/.context/settings.json desactivan la telemetría globalmente sin necesidad de cuenta Consumer.

⚖️ /policy (Políticas de Orquestación)

Inspecciona y muestra las políticas de selección y fallback de la fase 4 del motor de orquestación (alias: /politica, /politicas). Soporta ejecución no interactiva.

  • Sintaxis:
    text
    /policy                                # alias de /policy list
    /policy list                           # lista políticas disponibles
    /policy show <modo>[:<objetivo>]       # detalla scoring y fallbacks
  • Modos disponibles: manual, score, score-with-fallback, fallback-only.
  • Objetivos de optimización: balanced, cost, latency, quality, capability, resilience.
  • Caso de uso: antes de lanzar un /swarm-auto largo, verifica con /policy show score:cost qué pesos usará el scorer para asignar agentes a tareas. La salida incluye los DEFAULT_SCORING_WEIGHTS aplicados.

🪝 /hooks (Configuración de Hooks)

Abre el menú visual de configuración de hooks (alias: /ganchos). Los hooks son scripts que la CLI ejecuta automáticamente en eventos del ciclo de vida y pueden bloquear o modificar acciones.

  • Sintaxis:
    text
    /hooks
  • Eventos soportados:
    • Ciclo de sesión: SessionStart, SessionEnd, Setup, Stop, StopFailure, Notification.
    • Herramientas: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest, PermissionDenied.
    • Compactación e instrucciones: PreCompact, PostCompact, InstructionsLoaded, UserPromptSubmit.
    • Sub-agentes y tareas: SubagentStart, SubagentStop, TaskCreated, TaskCompleted, TeammateIdle.
    • Worktrees y entorno: WorktreeCreate, WorktreeRemove, CwdChanged, ConfigChange, Elicitation, ElicitationResult.
  • Detalle técnico: la configuración se guarda en settings.json bajo la clave hooks y se aplica a nivel proyecto, usuario o global. Un hook puede ser bloqueante (su salida es vista por el modelo o aborta la acción) o asíncrono (corre en paralelo sin retrasar al agente). Ver ~/.context/settings.json y los componentes en src/components/hooks/.

NOTE

/output-style (alias: /estilo-salida) está obsoleto y oculto en este fork — usa /config y la sección "Estilo de salida" para ajustar el formato de respuesta del agente.


💓 Diagnóstico y Sesión Remota

💗 /heartbeat (Estado del Latido de Sesión)

Muestra el estado del heartbeat de la sesión (alias: /latido) — el ping interno que detecta si el stdin se quedó bloqueado o si el bucle de eventos está vivo. Soporta ejecución no interactiva.

  • Sintaxis:
    text
    /heartbeat
  • Información mostrada:
    • Estado (✓ activo / ✗ inactivo), tiempo desde el último tick y desde el último evento de stdin.
    • Número de intentos de recuperación tras detectar stalls.
    • Plataforma, MSYSTEM y TERM_PROGRAM para diagnóstico cruzado.
  • Diagnóstico Git Bash + Windows: si la sesión detecta Git Bash sobre Windows, sugiere export MSYS=enable_pcon en ~/.bashrc o usar Windows Terminal con perfil Git Bash para evitar cuelgues en estado idle. Para tracing detallado al stderr, arranca con CONTEXT_HEARTBEAT_DEBUG=1.

📡 /remote-control (Control Remoto desde claude.ai)

Conecta este terminal para que pueda ser controlado desde una sesión remota en claude.ai (alias: /rc, /control-remoto). Requiere que BRIDGE_MODE esté compilado y el bridge habilitado — el comando queda oculto si no.

  • Sintaxis:
    text
    /remote-control          # toggle on/off
    /remote-control <nombre> # conecta con un nombre de entorno específico
  • Cómo funciona: activa replBridgeEnabled en el estado de la app, lo que dispara useReplBridge en el REPL: registra el entorno, crea una sesión asociada a la conversación actual, hace polling de trabajo entrante y abre un WebSocket bidireccional con claude.ai para mensajes en ambos sentidos.
  • Ejecutar de nuevo cuando ya está conectado: muestra un diálogo con la URL de la sesión y opciones para desconectar o seguir conectado.
  • Requisitos previos: haber ejecutado el login del bridge — si no hay token de acceso, el comando muestra BRIDGE_LOGIN_INSTRUCTION con los pasos a seguir.

⚡ Comandos de Automatización e Integración

🏃 /run (Ejecución Aislada de Scripts)

Permite correr comandos o scripts específicos de consola a través de un canal controlado por el agente.

  • Sintaxis:
    text
    /run <comando_consola>
  • Detalle técnico: Cuando /run se ejecuta, el agente delega la llamada a un submódulo con protección de variables de entorno para evitar escapes accidentales o ejecuciones que alteren el flujo de la terminal interactiva.

🆙 /upgrade (Actualización de la CLI)

Comprueba las versiones estables en el registro y actualiza Context Code de forma automática a su última release.

  • Sintaxis:
    text
    /upgrade

🔦 /torch (Auditoría Sintáctica)

Analiza archivos de código fuente en caliente para detectar de forma visual errores de sintaxis o declaraciones truncadas, iluminando los puntos críticos del workspace.

  • Sintaxis:
    text
    /torch <ruta_archivo>

🛠️ /autofix-pr (Correcciones de Pull Requests)

Toma como entrada una rama o Pull Request (PR) conflictivo y realiza de forma autónoma correcciones, refactorizaciones y fixes de lints y tests antes de su fusión.

  • Sintaxis:
    text
    /autofix-pr <url_pr | id_pr>

🧠 Comandos de Control Cognitivo y Esfuerzo

⚖️ /effort (Modo de Razonamiento del LLM)

Ajusta la intensidad o nivel de esfuerzo computacional y razonamiento lógico a bajo nivel que aplicará el modelo (especialmente con modelos de la serie o1/o3 de OpenAI o Claude Thinking).

  • Sintaxis:
    text
    /effort <low | medium | high>
  • Caso de uso:
    • low: Para tareas rápidas de renombrado, creación de HTML simple o lints de compilación.
    • high: Para resolver problemas complejos de concurrencia, reestructuración de bases de datos o depuración de memory leaks.

🌿 Bifurcaciones y Red Local (P2P)

🔱 /fork (Bifurcación de Sub-Agentes)

Crea una bifurcación (fork) del contexto de la conversación actual para arrancar un sub-agente asíncrono en un hilo secundario en paralelo.

  • Sintaxis:
    text
    /fork <tarea_secundaria>
  • Detalle técnico: Útil para no interrumpir tu chat interactivo principal. El sub-agente corre de fondo y reporta el resultado directamente en el historial al terminar su ejecución de forma paralela.

🤝 /buddy (Compañero Interactivo)

Activa un asistente interactivo secundario de acompañamiento estético en tu consola.

  • Sintaxis:
    text
    /buddy [start | stop]

🌐 /peers (Conexión P2P de Consolas)

Establece canales de comunicación locales Unix Domain Sockets (UDS) para compartir contexto, logs y estados de desarrollo en tiempo real entre múltiples terminales de Context Code en la misma red local.

  • Sintaxis:
    text
    /peers [listar | conectar]

🧩 Plugins y Habilidades

🔄 /reload-plugins (Aplicar Cambios de Plugin sin Reiniciar)

Aplica cambios de plugin pendientes a la sesión actual (alias: /recargar-plugins) — el "Layer-3 refresh". Es lo que necesitas tras editar un plugin local o instalar uno nuevo, sin tener que cerrar la sesión.

  • Sintaxis:
    text
    /reload-plugins
  • Detalle técnico: los consumidores del SDK no envían este comando como texto plano — usan query.reloadPlugins() (control request) que devuelve estructuras tipadas con commands, agents, plugins y mcpServers actualizados para que la UI los renderice.
  • Solo interactivo: no soporta ejecución no interactiva.
  • Diferencia con /plugin: /plugin lista/configura plugins; /reload-plugins aplica cambios ya hechos en disco a la sesión viva.

🛠️ Comandos de Desarrollo y Depuración Interna

NOTE

Estos comandos (INTERNAL_ONLY_COMMANDS) están diseñados principalmente para desarrolladores del motor y entornos de pruebas integrales.

  • 🐞 /bughunter: Ejecuta un motor autónomo que inyecta errores simulados en el código y comprueba si los verificadores locales de Context Code los detectan con éxito.
  • /break-cache: Fuerza la expiración y vaciado inmediato de la caché de contexto del modelo para medir latencias de red en frío.
  • 💸 /mockLimits: Permite simular llamadas de rate limits y cuotas de consumo para probar el comportamiento de robustez ante errores 429.
  • 🔄 /bridge-kick: Envía una señal de reinicio física e inmediata sobre los bridges activos de WhatsApp y Telegram ante caídas del WebSocket.
  • ✂️ /force-snip: Fuerza un recorte inmediato de los mensajes más antiguos del buffer para liberar tokens del búfer local.

Desarrollado con pasión e Inteligencia Artificial.