theus-cli 0.1.11 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +27 -0
  2. package/cli.js +1412 -487
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -102,6 +102,33 @@ Al iniciar dentro de un proyecto, el servicio de inteligencia local indexa archi
102
102
 
103
103
  ---
104
104
 
105
+ ## 🧭 Ñaupa (motor de inteligencia de código)
106
+
107
+ Si el binario [`naupa`](https://theus.pe/naupa/) está instalado, Theus lo monta **automáticamente** como servidor MCP (`theus-naupa`) en cada sesión: grafo de conocimiento AST del proyecto (tree-sitter, 158 lenguajes), cadenas de llamadas, consultas Cypher y análisis de impacto en <1 ms — el agente consulta la estructura antes de recurrir a grep/read.
108
+
109
+ ```bash
110
+ curl -fsSL https://theus.pe/naupa.sh | bash # instalar Ñaupa
111
+ THEUS_NO_NAUPA=1 theus # kill-switch por sesión
112
+ ```
113
+
114
+ Las tools de lectura (`search_graph`, `trace_path`, `query_graph`, `get_architecture`, …) van pre-permitidas; las que escriben (`index_repository`, `delete_project`, …) pasan por el flujo de permisos normal. Caché en `~/.theus/naupa/`. Código: `services/mcpNaupa/`. Docs: [theus.pe/docs/naupa](https://theus.pe/docs/naupa).
115
+
116
+ ---
117
+
118
+ ## 🖥️ Computer-use (control de escritorio — macOS)
119
+
120
+ Theus puede ver la pantalla y operarla (mouse + teclado). Implementación propia, **sin addons compilados**: se apoya en herramientas nativas del sistema (`screencapture`, `sips`, `cliclick`, `osascript`). Es **opt-in** y solo macOS.
121
+
122
+ ```bash
123
+ brew install cliclick # única dependencia externa
124
+ theus --theus-computer-use-selftest # certifica captura+control en tu Mac
125
+ THEUS_COMPUTER_USE=1 theus # arranca con computer-use montado
126
+ ```
127
+
128
+ Requiere otorgar **dos permisos** al app que corre Theus (tu terminal), en Ajustes del Sistema → Privacidad y seguridad: **Grabación de pantalla** y **Accesibilidad**. Sin ellos, las tools devuelven un error accionable (no rompen el turno). El agente trabaja tomando un `screenshot`, razonando sobre la imagen y dando coordenadas en píxeles; el server las mapea a puntos lógicos de la pantalla. Tools MCP: `mcp__theus-computer-use__{screenshot,left_click,double_click,right_click,mouse_move,left_click_drag,type,key,scroll,cursor_position,wait,permissions}` (`services/mcpComputerUse/`).
129
+
130
+ ---
131
+
105
132
  ## 🛠️ Desarrollo
106
133
 
107
134
  ```bash