Referencia de comandos

Los comandos, flags y subcomandos del binario theus, más los comandos de barra (/) disponibles dentro de una sesión. Las funciones que necesitan una cuenta o un servicio configurado se indican en su sección. Los modos autónomos beta se documentan en Modos autónomos (beta).

Ejecuta Theus sin argumentos para abrir una sesión interactiva en el directorio actual. Pasa un prompt como primer argumento para sembrar la sesión, o usa -p/--print para una salida no interactiva:

theus                        # sesión interactiva
theus "explica este repo"    # siembra la sesión con un prompt
theus -p "lista los tests"   # imprime la respuesta y sale
theus --version              # imprime la versión y sale

Theus abre una sesión interactiva por defecto. Usa -p/--print para una salida apta para tuberías. En modo -p se omite el diálogo de confianza del espacio de trabajo, así que ejecútalo solo en directorios en los que confíes.

Flags globales

Aplican al comando por defecto (sesión). Aquí se listan las opciones más usadas; la lista autoritativa para tu versión siempre es theus --help.

Flag	Qué hace
`-h, --help`	Muestra la ayuda del comando.
`-v, --version`	Imprime la versión y sale.
`-p, --print`	Imprime la respuesta y sale (útil para tuberías). Omite el diálogo de confianza del espacio de trabajo.
`-d, --debug [filtro]`	Activa el modo de depuración, con filtrado opcional por categoría (p. ej. `"api,hooks"`).
`--verbose`	Sobrescribe la opción de verbosidad de la configuración.
`--bare`	Modo mínimo: omite hooks, LSP, sincronización de plugins, auto-memoria y precargas en segundo plano.
`-c, --continue`	Continúa la conversación más reciente en el directorio actual.
`-r, --resume [valor]`	Reanuda una conversación por ID de sesión, o abre el selector interactivo con un término de búsqueda opcional.
`--fork-session`	Al reanudar, crea un ID de sesión nuevo en vez de reutilizar el original.
`--model <modelo>`	Modelo para la sesión actual. Acepta un alias configurado o un id de modelo del proveedor.
`--effort <nivel>`	Nivel de esfuerzo de la sesión: `low`, `medium`, `high`, `max`.
`--agent <agente>`	Agente para la sesión actual. Sobrescribe la opción `agent`.
`--permission-mode <modo>`	Modo de permisos de la sesión.
`--dangerously-skip-permissions`	Omite todas las comprobaciones de permisos. Recomendado solo en entornos aislados sin acceso a internet.
`--allowedTools <tools...>`	Lista de herramientas permitidas (p. ej. `"Bash(git:*) Edit"`).
`--disallowedTools <tools...>`	Lista de herramientas denegadas.
`--add-dir <directorios...>`	Directorios adicionales a los que las herramientas pueden acceder.
`--mcp-config <configs...>`	Carga servidores MCP desde archivos o cadenas JSON.
`-n, --name <nombre>`	Da un nombre visible a esta sesión (aparece en `/resume` y en el título de la terminal).
`--ide`	Se conecta automáticamente al IDE al arrancar cuando hay exactamente uno válido.
`-w, --worktree [nombre]`	Crea un nuevo worktree de git para esta sesión (opcionalmente con nombre).
`--output-format <formato>`	Formato de salida (con `--print`): `text`, `json` o `stream-json`.

Subcomandos

Además del comando de sesión por defecto, el binario theus expone varios subcomandos. Ejecuta theus <subcomando> --help para el detalle.

Subcomando	Qué hace
`theus mcp`	Configura y gestiona servidores MCP (`serve`, `list`, `get`, `add-json`, `remove`).
`theus auth`	Gestiona la autenticación: `login`, `status`, `logout`.
`theus plugin` (alias `plugins`)	Gestiona plugins de Theus: `list`, `install`, `uninstall`, `enable`, `disable`, `update`, `validate`, más el subgrupo `marketplace`.
`theus agents`	Lista los agentes configurados.
`theus doctor`	Revisa el estado del autoactualizador y de la instalación de Theus.
`theus update` (alias `upgrade`)	Comprueba si hay actualizaciones y las instala (también actualiza Ñaupa).
`theus install [destino]`	Imprime cómo instalar o actualizar Theus (npm o instalador de `theus.pe`). No instala nada por su cuenta.
`theus completion <shell>`	Genera un script de autocompletado (bash, zsh o fish).

El inicio de sesión también es accesible directamente: el lanzador intercepta login, signin y entrar y los enruta al flujo de inicio de sesión de Theus.

Comandos de barra

Dentro de una sesión interactiva, escribe / para abrir la paleta de comandos. Escribe /help en cualquier momento para ver la lista completa disponible en tu sesión (las habilidades y plugins añaden más). Donde existe un nombre en español, se muestra como principal y el alias en inglés entre paréntesis.

Modelos e inteligencia

Comando	Qué hace
`/modelos`	Explica cómo Theus te da acceso a los mejores modelos vía TITAN y muestra el catálogo.
`/modelo` (alias `/model`)	Elige el modelo de IA de la sesión.
`/imagen`	Genera una imagen con tu suscripción. Puedes pedir el formato (vertical 9:16, horizontal 16:9). Theus ve el resultado y lo corrige si no cuadra. Alias: `/image`, `/img`.
`/video`	Genera un video con tu suscripción; opcionalmente indicas la duración. También puede animar una imagen que le pases. Alias: `/vid`.
`/inteligencia`	Define el nivel de inteligencia/esfuerzo del modelo con una barra animada.
`/effort`	Fija el nivel de esfuerzo del modelo por argumento (usa `/inteligencia` para la barra animada).
`/providers`	Conecta modelos locales, tus propias API keys y endpoints personalizados.

Sesión

Comando	Qué hace
`/help`	Muestra la ayuda y los comandos disponibles.
`/resume`	Reanuda una conversación anterior.
`/rewind`	Restaura el código y/o la conversación a un punto anterior.
`/copy`	Copia la última respuesta de Theus al portapapeles (o `/copy N` para la N-ésima más reciente).
`/export`	Exporta la conversación actual.
`/plan`	Entra en modo plan o muestra el plan de la sesión actual.
`/onboarding`	Vuelve a mostrar la bienvenida y configuración inicial de Theus.
`/novedades`	Novedades de Theus: qué trae cada versión (empaquetadas con el CLI, sin conexión).
`/version`	Muestra la versión que ejecuta esta sesión (no la que descargó el autoactualizador).
`/teleport`	Lista tus sesiones remotas de código y el comando exacto para reanudar cada una.
`/brief`	Activa o desactiva el modo de respuestas breves. Encendido por defecto; `THEUS_BRIEF=0` lo apaga.
`/fork`	Lanza subagentes en segundo plano que heredan tu contexto (consume tokens extra por lanzamiento). Encendido por defecto; `THEUS_FORK=0` lo apaga.
`/buddy`	Tu compañero de terminal: nace una vez y comenta tus turnos. Encendido por defecto; `THEUS_BUDDY=0` lo apaga.
`/multiplesagentes` (alias `/workflows`, `/workflow`, `/wf`)	Lista y ejecuta recetas que coordinan subagentes en segundo plano con los modelos y permisos de la sesión. Disponible por defecto; `THEUS_WORKFLOWS=0` desactiva el comando y su herramienta. Ver Recetas del CLI.

Contexto

Comando	Qué hace
`/clear`	Borra el historial de la conversación y libera contexto.
`/compact [instrucciones]`	Limpia el historial conservando un resumen en el contexto. Admite instrucciones de resumen opcionales.
`/context`	Visualiza el uso actual del contexto como una cuadrícula de colores.
`/memory`	Edita los archivos de memoria de Theus.
`/files`	Lista todos los archivos actualmente en el contexto.
`/tag`	Alterna una etiqueta buscable en la sesión actual.
`/init`	Inicializa el/los archivo(s) de instrucciones del proyecto (y habilidades/hooks) a partir del código.

Git

Comando	Qué hace
`/commit`	Crea un commit de git.
`/commit-push-pr`	Crea un commit, hace push y abre un pull request.
`/review`	Revisa un pull request.
`/diff`	Muestra los cambios sin commitear y los diffs por turno.

MCP y habilidades

Comando	Qué hace
`/mcp`	Gestiona servidores MCP.
`/skills`	Lista las habilidades disponibles.
`/agents`	Gestiona las configuraciones de agentes. Con `/agents activos`, revisa los subagentes en ejecución, sus resultados y transcripciones, o detén uno.

Operación y cuenta

Comando	Qué hace
`/estado` (alias `/status`)	Estado de Theus: versión, modelo, cuenta, conectividad de la API y herramientas.
`/doctor`	Diagnostica y verifica tu instalación y configuración de Theus.
`/higiene` (alias `/limpieza`)	Revisa y limpia las marcas invisibles y los metadatos de procedencia del proyecto. Sin argumentos audita y no toca nada; `limpiar`, `fichero <ruta>`, `modo` y `estado` son los subcomandos. Viene con los planes altos. Ver Higiene.
`/uso`	Tu consumo de la suscripción: cuota de créditos del ciclo, por modelo y fecha de renovación.
`/recarga`	Compra un pack de créditos prepago sin salir de la terminal: selector con tu saldo y los precios, abre el pago en el navegador y espera la acreditación para mostrarte el saldo nuevo. Los packs suman créditos; no suben de plan. Ver Recarga de créditos.
`/upgrade`	Abre la vitrina de planes en el navegador para mejorar el tuyo. Si ya estás en el plan más alto de tu riel (Omnipotente, en dólares o en soles) te lo dice y no abre nada. Ver Planes y suscripción.
`/cost`	Muestra el costo total y la duración de la sesión actual.
`/permissions`	Gestiona las reglas de permisos de herramientas (permitir y denegar).
`/config`	Abre el panel de ajustes.
`/theme`	Cambia el tema.
`/vim`	Alterna entre los modos de edición Vim y Normal.
`/keybindings`	Abre (o crea) tu archivo personal de atajos en `~/.theus/keybindings.json`. Ver Atajos de teclado.
`/login`	Inicia sesión en tu cuenta Theus.
`/logout`	Cierra sesión de tu cuenta Theus.

Compartir una conversación

/share (alias /compartir) está implementado para sesiones OAuth de Theus con una cuenta elegible. Las operaciones necesitan el servicio de conversaciones compartidas del gateway. Sin argumentos muestra ayuda y no publica nada.

/share crear              # crea un enlace público de sólo lectura
/share lista              # consulta tus enlaces
/share revocar <token>    # retira un enlace concreto

Se comparte únicamente el texto de los turnos de usuario y asistente; no se incluyen pasos internos, imágenes, documentos ni videos. Cualquier persona que tenga el enlace puede leer ese texto: revisa la conversación antes de compartirla. lista no revoca enlaces.

Un error de red o del servicio se muestra como error. Crear el enlace requiere dos solicitudes; si falla la segunda, puede quedar creada una conversación privada sin enlace público. La disponibilidad del comando no garantiza que el servicio remoto admita la operación.

Vincular un canal

/telegram abre el asistente de vinculación. Necesita una sesión OAuth y que el canal esté configurado en el gateway. Muestra un QR o enlace, comprueba la vinculación durante unos tres minutos y permite salir con Esc o q. Salir detiene la comprobación; no desvincula una cuenta que ya se haya enlazado.

La vinculación no activa una sesión remota. Control Remoto sigue siendo beta, requiere activación expresa y depende de infraestructura remota en desarrollo. Un canal vinculado no acredita por sí solo que el intercambio de mensajes o permisos esté operativo.

Algunas opciones dependen de tu cuenta, configuración o instalación y pueden no aparecer en todos los entornos. La lista autoritativa para tu versión siempre es theus --help y /help. Los modos beta proactivo y asistente se documentan aparte en Modos autónomos (beta).