Ir al contenido

Todos los comandos

contextcode --help los lista todos; contextcode <comando> --help enseña las opciones de uno.

ComandoQué hace
contextcode chatChat interactivo en la terminal. Usa una interfaz de pantalla completa si la terminal es interactiva, y un REPL plano si la salida va a un archivo; --tui y --plain lo fuerzan. Acepta --modelo, --cwd y --continuar.
contextcode run "<prompt>"Un turno del agente y sale. Ideal para scripts y tareas programadas. Acepta --modelo.

Son dos cosas distintas y se confunden a menudo: login es tu cuenta de Context Code; provider es el modelo de IA que usa el agente.

ComandoQué hace
contextcode login [--email <correo>]Inicia sesión de la licencia. Es la única vía en un servidor sin pantalla.
contextcode login --statusEstado de la licencia, sin pedirte nada.
contextcode logoutOlvida las credenciales de este equipo (no cancela la suscripción).
contextcode provider login <proveedor> [--key]Conecta el motor de IA: claude, gemini-api, openai, copilot, zai, ollama… Con --key sin valor pide la clave sin mostrarla; --key - la lee de stdin.
contextcode provider statusProveedores configurados y cuál está activo.
contextcode modelos [--json]Modelos disponibles por proveedor, con el activo marcado.
contextcode modelos usar <id>Fija el modelo que usan chat y run, el mismo del selector de la aplicación.
contextcode uso [hoy|semana|mes|todo]Tokens y coste, como el panel de uso.
contextcode statusQué runtimes empaquetados (Node, uv, npx) se van a usar de verdad.

Levanta el servidor web que escanea el móvil, sin abrir ventana. Se queda corriendo hasta que lo cortes con Ctrl+C (o para siempre, con --install).

OpciónQué hace
--print-qrPinta el QR del enlace en la terminal. Con URL pública, el QR es el de esa URL y la de la red local va debajo. La URL sale por stdout y los avisos por stderr, así que contextcode serve --print-qr | head -1 te da la URL limpia.
--publicPublica por un túnel público en vez de la IP de la red local. Usa la URL fija del equipo si la tiene o la puede pedir; si no, un túnel temporal cuya URL cambia en cada arranque. Imprescindible en un VPS.
--stableComo --public, pero siempre con la URL fija del equipo. Requiere el plan con servidores remotos.
--port NPuerto de escucha (por defecto 8787, o el del enlace guardado).
--bind 127.0.0.1IP de escucha. Detrás de nginx, caddy o un túnel SSH, para no exponer el puerto en claro.
--minutes NVida del enlace nuevo, de 1 a 43 200 minutos (30 días).
--token-file <ruta>Token estable en un archivo con permisos 0600, sin depender del llavero del sistema. Es lo que usa el servicio.
--installInstala serve como servicio de usuario (systemd en Linux, LaunchAgent en macOS, tarea programada en Windows) y lo arranca. Al terminar imprime la URL y el QR que usará el servicio.
--uninstallLo detiene y lo quita.
ComandoQué hace
contextcode dispositivos [--json]Teléfonos emparejados: nombre, id, emparejado, último uso e IP.
contextcode dispositivos revocar <id|nombre>Les quita el acceso al momento, aunque el servidor esté corriendo. --todos para todos, --si sin confirmación.

Cómo dejarlo como servicio, qué URL lleva el QR y qué revisar si el teléfono no conecta: Acceso remoto desde un servidor.

ComandoQué hace
contextcode remoto agregar <nombre> <url> [--token T]Da de alta un Context Code remoto y se empareja con él.
contextcode remoto listar [--json]Los remotos configurados. Nunca imprime credenciales.
contextcode remoto usar <nombre>Fija cuál se usa cuando no dices el nombre.
contextcode remoto quitar <nombre>Borra la credencial de este equipo.
contextcode remoto probar [<nombre>]Comprueba que responde, que la credencial vale y qué hay al otro lado.
contextcode chat --remoto [<nombre>]Chat en la terminal contra el agente de otra máquina.

Todo el detalle, en Otro Context Code desde aquí.

ComandoQué hace
contextcode canal telegram|slack|whatsappDeja el agente escuchando ese canal, sin ventana, hasta Ctrl+C. Acepta --workspace y --model.
contextcode canal configurar <canal>Guarda y valida el token del bot, pidiéndolo sin mostrarlo.
contextcode canal estadoQué canales tienen credenciales, sin mostrarlas.
contextcode automatizaciones listar|crear|borrar|activar|desactivar|ejecutarLas mismas automatizaciones de la aplicación.
contextcode tickUna pasada del planificador de automatizaciones y sale. Es lo que invoca la tarea programada del sistema.
ComandoQué hace
contextcode mcp listar|agregar|quitar|probarServidores MCP, en los mismos ámbitos que la aplicación.
contextcode skills listar|instalar|quitarSkills del proyecto y globales.
contextcode caja listar|guardar|rotar|borrarCaja fuerte del proyecto. Los valores se piden sin mostrarlos.

Ejemplos y opciones en Administrar desde la terminal.

ComandoQué hace
contextcode conexionDónde está todo y cómo me conecto — ver su página. contextcode conexion --qr vuelve a mostrar el QR del servicio que está corriendo.
contextcode instalar-cli [--mostrar]Deja contextcode en el PATH donde el instalador no pudo.
contextcode update [--check]Actualiza el binario (servidores Linux).
CódigoSignifica
0Éxito (también --help y --version).
1La acción se ejecutó pero falló.
2Uso incorrecto: argumento desconocido o falta un valor.

Sin ningún comando, contextcode arranca la aplicación de escritorio; con --minimized, oculta en la bandeja.