theus-cli 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,78 @@
+LICENCIA COMERCIAL PROPIETARIA DE THEUS
+Copyright (c) 2026 Marketrix / Theus (theus.pe). Todos los derechos reservados.
+
+1. TITULARIDAD
+   Este software, denominado "Theus CLI" o "Theus", incluyendo su codigo
+   fuente, binarios, bundles compilados, documentacion, marcas, logotipos,
+   arte y demas materiales asociados (en conjunto, el "Software"), es
+   propiedad exclusiva de Marketrix ("el Titular"), operador del dominio
+   comercial theus.pe.
+
+2. LICENCIA LIMITADA DE USO
+   Sujeto al cumplimiento de estos terminos y, cuando corresponda, al pago
+   del plan de suscripcion vigente contratado a traves de theus.pe, el
+   Titular concede al usuario una licencia limitada, personal, revocable,
+   no exclusiva, no transferible y no sublicenciable para instalar y
+   ejecutar el Software con fines de uso del producto Theus.
+
+3. RESTRICCIONES
+   Salvo autorizacion previa, expresa y por escrito del Titular, el usuario
+   NO puede:
+   a) copiar, distribuir, publicar, alquilar, prestar, vender o revender el
+      Software, en todo o en parte;
+   b) modificar, traducir, adaptar o crear obras derivadas del Software;
+   c) realizar ingenieria inversa, descompilar o desensamblar el Software,
+      salvo en la medida en que la ley aplicable lo permita de forma
+      imperativa;
+   d) eliminar, ocultar o alterar avisos de derechos de autor, marcas o
+      atribuciones incluidos en el Software;
+   e) usar el Software para construir un producto o servicio que compita
+      con Theus;
+   f) usar las marcas "Theus", "theus.pe" o el arte asociado fuera del uso
+      normal del producto.
+
+4. SUSCRIPCIONES Y SERVICIOS
+   Determinadas funciones del Software dependen de servicios en linea del
+   Titular (por ejemplo, el gateway de modelos y la consola de theus.pe) y
+   pueden requerir una suscripcion de pago activa. El Titular puede
+   modificar, suspender o descontinuar dichos servicios conforme a los
+   terminos comerciales publicados en theus.pe.
+
+5. CODIGO DE TERCEROS
+   El Software puede incluir componentes de terceros sujetos a sus propias
+   licencias. Nada en esta licencia limita los derechos que dichas
+   licencias otorgan sobre esos componentes; sus avisos se conservan en los
+   archivos correspondientes.
+
+6. PROPIEDAD INTELECTUAL
+   El Software se licencia, no se vende. El Titular conserva todos los
+   derechos, titulos e intereses sobre el Software que no se conceden
+   expresamente en esta licencia.
+
+7. SIN GARANTIAS
+   EL SOFTWARE SE ENTREGA "TAL CUAL" Y "SEGUN DISPONIBILIDAD", SIN
+   GARANTIAS DE NINGUN TIPO, EXPRESAS O IMPLICITAS, INCLUYENDO SIN
+   LIMITACION GARANTIAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPOSITO
+   PARTICULAR Y NO INFRACCION.
+
+8. LIMITACION DE RESPONSABILIDAD
+   EN LA MAXIMA MEDIDA PERMITIDA POR LA LEY, EL TITULAR NO SERA RESPONSABLE
+   POR DANOS INDIRECTOS, INCIDENTALES, ESPECIALES, PUNITIVOS O
+   CONSECUENTES, NI POR PERDIDA DE DATOS, LUCRO CESANTE O INTERRUPCION DE
+   NEGOCIO, DERIVADOS DEL USO O LA IMPOSIBILIDAD DE USO DEL SOFTWARE.
+
+9. TERMINACION
+   Esta licencia termina automaticamente si el usuario incumple cualquiera
+   de sus terminos o si finaliza la suscripcion que la habilita. Al
+   terminar, el usuario debe cesar todo uso del Software y eliminar las
+   copias en su poder.
+
+10. LEY APLICABLE
+    Esta licencia se rige por las leyes de la Republica del Peru. Cualquier
+    controversia se somete a la jurisdiccion de los tribunales de Lima,
+    Peru.
+
+Para licencias corporativas, redistribucion u otros permisos, contacta al
+Titular a traves de theus.pe.
+
+THEUS — HECHO EN PERU · AD ASTRA PER ASPERA

package/README.md

@@ -21,59 +21,60 @@ Esto ya no es un documento de estudio ni una propuesta de rebrand. Este reposito
 ## Instalacion para usuarios
 
 Requisito de runtime: **Bun**. Theus se compila y se ejecuta con Bun (`cli.js` es
-un bundle con target `bun`, no corre bajo Node). Si no tienes Bun, cualquiera de
-las opciones de abajo lo instala por ti, o hazlo manualmente:
+un bundle con target `bun`, no corre bajo Node). El instalador oficial instala
+Bun por ti si falta (descargando el binario oficial y verificando su checksum
+SHA-256).
 
-```bash
-curl -fsSL https://bun.sh/install | bash
-```
-
-### Opcion A — npm (global)
+### Opcion A — instalador oficial (recomendada)
 
 ```bash
-npm install -g theus-cli
+curl -fsSL https://theus.pe/install.sh | bash
 theus --version
 ```
 
-Uso normal:
-
-```bash
-cd /ruta/de/tu/proyecto
-theus
-```
+El instalador detecta tu plataforma (macOS/Linux, x64/arm64), descarga el
+tarball del ultimo release de `MarketrixPE/theuscode` verificando su SHA-256,
+lo instala en `~/.theus/app` y enlaza el comando `theus` en tu PATH. Si aun no
+hay release publicado, cae automaticamente a instalar desde el codigo fuente
+(clona el repo y compila el bundle localmente).
 
-Actualizar Theus cuando publiquemos una nueva version:
+Variables opcionales del instalador:
 
-```bash
-theus update
-# o dentro del chat:
-/update
-```
+| Variable | Efecto |
+| --- | --- |
+| `THEUS_INSTALL_MODE` | `auto` (def), `release` o `source` |
+| `THEUS_VERSION` | tag del release, p.ej. `v0.1.3` (def: `latest`) |
+| `THEUS_REF` / `THEUS_COMMIT` | rama y commit fijado para modo `source` |
+| `THEUS_HOME` | carpeta de instalacion (def: `~/.theus/app`) |
+| `THEUS_BIN_DIR` | donde enlazar `theus` (def: primer dir escribible del PATH) |
 
-Ejecucion puntual sin instalar (descarga temporal):
+Uso normal despues de instalar:
 
 ```bash
-npx theus-cli --help
+cd /ruta/de/tu/proyecto
+theus
 ```
 
-> Nota: el paquete publica un unico bundle self-contained (`cli.js`) con shebang
-> `#!/usr/bin/env bun`. `npm install -g` crea el enlace `theus` apuntando a ese
-> bundle; necesitas Bun en el PATH para ejecutarlo.
+Para actualizar, vuelve a ejecutar el instalador (es idempotente).
 
-### Opcion B — instalador (curl | bash)
+### Opcion B — manual, desde un release
 
-Instala Bun si falta, clona el CLI, compila el bundle y enlaza `theus` en tu PATH:
+Descarga el tarball y el archivo de checksums desde
+`https://github.com/MarketrixPE/theuscode/releases`, verifica e instala:
 
 ```bash
-curl -fsSL https://theus.pe/install.sh | bash
+curl -fsSLO https://github.com/MarketrixPE/theuscode/releases/latest/download/theus-cli.tar.gz
+curl -fsSLO https://github.com/MarketrixPE/theuscode/releases/latest/download/SHA256SUMS
+shasum -a 256 -c SHA256SUMS --ignore-missing   # (en Linux: sha256sum -c)
+mkdir -p ~/.theus && tar -xzf theus-cli.tar.gz -C ~/.theus && mv ~/.theus/theus-cli ~/.theus/app
+ln -sf ~/.theus/app/bin/theus ~/.local/bin/theus
 ```
 
-Variables opcionales del instalador: `THEUS_REPO_URL`, `THEUS_REF`, `THEUS_HOME`,
-`THEUS_BIN_DIR`. El script vive en `scripts/install.sh`.
-
-### Opcion C — desde el repositorio (desarrollo)
+### Opcion C — manual, desde el repositorio (desarrollo)
 
 ```bash
+git clone https://github.com/MarketrixPE/theuscode.git
+cd theuscode
 bun install
 bun run build        # genera cli.js self-contained
 ./cli.js --version   # o: bun run dev
@@ -86,6 +87,12 @@ bundle compilado:
 ln -sf "$(pwd)/cli.js" /usr/local/bin/theus
 ```
 
+> Nota: la publicacion en npm (`npm install -g theus-cli`) esta preparada en
+> `package.json` pero el paquete aun no esta publicado en el registry. Los
+> releases se generan con `bun run release` (`scripts/release.ts`) y el
+> workflow `.github/workflows/release.yml` los publica al pushear un tag
+> `vX.Y.Z`.
+
 ## Conectar un modelo
 
 Theus lee primero variables `THEUS_*`. Puedes apuntar a Ollama, LM Studio, LiteLLM, OpenRouter, un gateway propio o cualquier servidor OpenAI-compatible.
@@ -170,6 +177,11 @@ theus login
 
 Ese comando abre `https://theus.pe/cai/oauth/authorize`, recibe el callback local, intercambia `code` por token OAuth y crea una API key Theus para configurar la terminal. La ruta de suscripcion dentro del CLI tambien apunta a `https://theus.pe/cai/oauth/authorize`; no debe abrir dominios externos como flujo principal de producto.
 
+Al completarse, `theus login` instala tambien el proveedor oficial
+`theus-official` en `~/.theus/providers.json` con base
+`https://theus.pe/v1` y modelo `theus-router-auto`. Asi el usuario puede
+entrar con `theus` y enviar prompts sin exportar variables manuales.
+
 Variables utiles:
 
 | Variable | Uso |
@@ -184,6 +196,8 @@ Variables utiles:
 | `THEUS_DISABLE_TOOLS=1` | Desactiva tool-calling para endpoints simples |
 | `THEUS_NO_PROJECT_INTELLIGENCE=1` | No levanta indice/API/dashboard |
 | `THEUS_NO_OPEN_DASHBOARD=1` | Levanta API sin abrir el navegador |
+| `THEUS_START_MENU=1` | Muestra el menu visual de arranque antes del prompt |
+| `THEUS_NO_START_MENU=1` | Fuerza saltar el menu visual incluso si se pidio |
 | `PROJECT_API_PORT=65235` | Fija el puerto local |
 | `INDEX_MAX_FILES=2500` | Limite de archivos indexados |
 | `THEUS_ENABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1` | Opt-in para marketplace oficial |