Referencia de comandos

Los comandos, flags y subcomandos reales del binario theus, más los comandos de barra (/) disponibles dentro de una sesión. Esta página lista solo funciones GA (disponibles de forma general); los modos beta viven 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]`	Instala el build nativo de Theus (`stable`, `latest` o una versión concreta).
`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. Estos son los comandos GA integrados. 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.
`/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`)	Lista, ejecuta y gestiona orquestaciones de múltiples agentes: scripts que coordinan varios subagentes en segundo plano. Encendido por defecto; `THEUS_WORKFLOWS=0` lo apaga. Ver Modos autónomos.

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.

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.
`/uso`	Tu consumo de la suscripción: cuota de Theus Tokens del ciclo, por modelo y fecha de renovació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.

Esta página lista comandos GA del build actual. Algunas opciones dependen de tu tipo de cuenta o de tu 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).

Theus — agente de código local-first y multimodelo · Hecho en Perú