▶️ Ejecución y Flags (CLI)

Esta página documenta la ejecución del binario context como comando de terminal (no los Slash Commands). Para Slash Commands, usa: /guia/comandos.

---

✅ Modos de ejecución

1) Interactivo (por defecto)

context

• Abre la interfaz TUI.
• Aquí usas Slash Commands como /model, /provider, /mcp, /permissions, etc.

2) No interactivo (--print)

context -p "Resume este repositorio y dame un plan"

• Imprime la respuesta y termina el proceso.
• Es el modo recomendado para automatización (scripts/CI).

---

📤 Formatos de salida (--output-format)

--output-format solo aplica con --print.

• text (por defecto): texto plano.
• json: un resultado final serializado.
• stream-json: NDJSON (JSON por línea) con eventos estructurados (útil para integraciones y UIs).

Ejemplos:

context -p --output-format text "Explica este diff"

context -p --output-format json "Devuelve un checklist para revisar este PR"

context -p --output-format stream-json --verbose "Haz un diagnóstico del proyecto"

---

📥 Formatos de entrada (--input-format)

Para integraciones que alimentan la CLI por stdin.

• text: prompt como texto.
• stream-json: NDJSON para SDK/automatización avanzada.

Cuando uses stream-json en entrada/salida, normalmente quieres:

context -p --input-format stream-json --output-format stream-json --verbose

---

🧠 Modelo y razonamiento

--model <modelo>

Selecciona el modelo para esa ejecución/sesión:

context --model sonnet

--effort <low|medium|high|max>

Ajusta el nivel de esfuerzo en modelos compatibles:

context --effort high

--agent <agente>

Fija un “agente” (perfil) para la sesión cuando el runtime lo soporte:

context --agent "frontend"

---

💰 Límites y presupuestos

Context Code puede aplicar límites para controlar coste/uso (especialmente útil en automatización).

Opciones comunes:

• --max-turns <n>: máximo de turnos.
• --max-budget-usd <n>: presupuesto máximo en USD.

---

🧰 Herramientas: allow/deny

--allowed-tools <...>

Permite un subconjunto de herramientas (ideal para “modo seguro” en CI):

context -p --allowed-tools "Read" "Bash(git:*)" "Edit" "Write"

--disallowed-tools <...>

Bloquea herramientas específicas:

context -p --disallowed-tools "WebFetch" "WebSearch"

---

🔌 MCP desde CLI

• --mcp-config <...>: carga servidores MCP desde archivos JSON o cadenas.
• --strict-mcp-config: solo usa MCP de --mcp-config.

Guía completa: /cli/mcp

---

🔐 Permisos

--permission-mode <modo>

Modos típicos:

• default
• acceptEdits
• dontAsk
• plan
• bypassPermissions (requiere bandera adicional de “skip permissions”)

Guía completa: /cli/permisos

---

🧾 Config/Settings y fuentes

• --settings <archivo-o-json>: inyecta settings por archivo JSON o string JSON.
• --setting-sources <fuentes>: elige fuentes (user, project, local).
• --add-dir <...>: añade directorios permitidos para herramientas.

Guía completa: /cli/configuracion

---

🧩 Plugins

• --plugin-dir <ruta>: añade directorios de plugins (repetible).

Guía completa: /cli/plugins

---

🐞 Debug y logs

Opciones frecuentes:

• -d, --debug [filtro]
• --debug-file <ruta>
• --debug-to-stderr

Ver troubleshooting: /cli/troubleshooting