Todos los comandos
contextcode --help los lista todos; contextcode <comando> --help enseña las opciones de uno.
El agente
Sección titulada «El agente»| Comando | Qué hace |
|---|---|
contextcode chat | Chat 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. |
Cuenta y motor de IA
Sección titulada «Cuenta y motor de IA»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.
| Comando | Qué hace |
|---|---|
contextcode login [--email <correo>] | Inicia sesión de la licencia. Es la única vía en un servidor sin pantalla. |
contextcode login --status | Estado de la licencia, sin pedirte nada. |
contextcode logout | Olvida 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 status | Proveedores 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 status | Qué runtimes empaquetados (Node, uv, npx) se van a usar de verdad. |
Acceso remoto: serve
Sección titulada «Acceso remoto: serve»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ón | Qué hace |
|---|---|
--print-qr | Pinta 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. |
--public | Publica 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. |
--stable | Como --public, pero siempre con la URL fija del equipo. Requiere el plan con servidores remotos. |
--port N | Puerto de escucha (por defecto 8787, o el del enlace guardado). |
--bind 127.0.0.1 | IP de escucha. Detrás de nginx, caddy o un túnel SSH, para no exponer el puerto en claro. |
--minutes N | Vida 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. |
--install | Instala 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. |
--uninstall | Lo detiene y lo quita. |
| Comando | Qué 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.
Conectarse a OTRO Context Code
Sección titulada «Conectarse a OTRO Context Code»| Comando | Qué 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í.
Canales y automatización
Sección titulada «Canales y automatización»| Comando | Qué hace |
|---|---|
contextcode canal telegram|slack|whatsapp | Deja 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 estado | Qué canales tienen credenciales, sin mostrarlas. |
contextcode automatizaciones listar|crear|borrar|activar|desactivar|ejecutar | Las mismas automatizaciones de la aplicación. |
contextcode tick | Una pasada del planificador de automatizaciones y sale. Es lo que invoca la tarea programada del sistema. |
Extensiones y secretos
Sección titulada «Extensiones y secretos»| Comando | Qué hace |
|---|---|
contextcode mcp listar|agregar|quitar|probar | Servidores MCP, en los mismos ámbitos que la aplicación. |
contextcode skills listar|instalar|quitar | Skills del proyecto y globales. |
contextcode caja listar|guardar|rotar|borrar | Caja fuerte del proyecto. Los valores se piden sin mostrarlos. |
Ejemplos y opciones en Administrar desde la terminal.
Diagnóstico y mantenimiento
Sección titulada «Diagnóstico y mantenimiento»| Comando | Qué hace |
|---|---|
contextcode conexion | Dó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ódigos de salida
Sección titulada «Códigos de salida»| Código | Significa |
|---|---|
0 | Éxito (también --help y --version). |
1 | La acción se ejecutó pero falló. |
2 | Uso incorrecto: argumento desconocido o falta un valor. |
Sin ningún comando, contextcode arranca la aplicación de escritorio; con --minimized, oculta en la bandeja.
Asistente de la documentación
Responde solo con el manual de Context Code
Hola. Pregúntame cómo se usa Context Code y te respondo con lo que dice esta documentación, con enlaces a las páginas.
Te escucho…
Habla con normalidad. Cuando hagas una pausa te respondo en voz alta.
Puede equivocarse: confirma los detalles en las páginas enlazadas. 0/500