⌨️ CLI: Overview
La CLI de Context Code (comando context) es el motor principal del producto. Desde aquí puedes:
- Iniciar una sesión interactiva (TUI) para conversar con el agente.
- Ejecutar prompts en modo no interactivo (para scripts/CI) con
--print. - Controlar permisos, herramientas, MCP, plugins, hooks, modelos y configuración.
🧭 Formas de usar la CLI
1) Modo interactivo (TUI)
Inicia una conversación y usa Slash Commands dentro del prompt:
bash
context- Manual completo de comandos: /guia/comandos
2) Modo no interactivo (scripts/automatización)
Ideal para pipelines y tuberías:
bash
context -p "Explica este error y sugiere un fix"- Ver detalles y ejemplos: /cli/ejecucion
🧩 Conceptos clave
Session / Turn
- Una sesión es el contexto continuo (historial + configuración activa).
- Un turno es un ciclo completo: prompt → herramientas → respuesta → resultado.
Herramientas (Tools)
Context Code tiene un conjunto de herramientas integradas (p.ej. lectura/edición de archivos, terminal, web) y también puede extenderse con MCP.
- MCP (qué es y cómo se conecta): /cli/mcp
Permisos
Los permisos controlan qué acciones puede ejecutar el agente (y cuándo debe pedir confirmación).
- Permisos y modos: /cli/permisos
🧱 “Todo” lo que puedes controlar desde CLI (mapa)
- Ejecución y flags: formatos de entrada/salida, print mode, debug, model, agent, presupuesto → /cli/ejecucion
- Configuración y perfiles: settings, fuentes de config, perfiles de proveedor/modelo → /cli/configuracion
- Permisos y seguridad:
--permission-mode, allow/deny tools, modo plan → /cli/permisos - Hooks: automatización por eventos (SessionStart, PreToolUse, etc.) → /cli/hooks
- Plugins: comandos/skills distribuibles desde directorios locales → /cli/plugins
- MCP: servidores MCP, transports, configuración estricta → /cli/mcp
- Troubleshooting: /doctor, PATH, logs, errores típicos → /cli/troubleshooting