Astrax
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ASTRAX_HOME | No | Changes the location of the state/cache folder. By default it lives in a private user folder (~/.cache/astrax, ~/Library/Caches/astrax or %LOCALAPPDATA%\astrax), with restricted permissions. | |
| ASTRAX_JPEG_QUALITY | No | JPEG quality used for screen captures (30-95, default 65). | 65 |
| ASTRAX_REQUIRE_SESSION | No | Set to 0 to revert to the previous behavior without tasks or sessions (action tools no longer require an authorized task). | 1 |
| ASTRAX_SESSION_MINUTES | No | Duration of the authorized session during which Astrax can work unattended. Defaults to 60 minutes. | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| astrax_tarea_crearA | PASO 1 de toda petición multi-paso. Guarda el plan (pasos ordenados, cortos y concretos) en el archivo de estado. permisos_requeridos: TODO lo que necesitará la tarea completa, de entre pantalla, raton_teclado, portapapeles, terminal. Después muestra plan y permisos al usuario y pide UNA confirmación. |
| astrax_tarea_autorizarA | Concede los permisos de la tarea durante la sesión. Llamar SOLO tras mostrar el plan y recibir un 'sí' explícito del usuario. Nunca sin preguntarle. |
| astrax_tarea_estadoA | Lee el estado compacto: paso actual, siguiente y datos guardados. Úsalo al empezar cada paso EN LUGAR de releer el historial o capturas viejas. |
| astrax_tarea_guardarA | Guarda un dato clave de la tarea (p. ej. pdf_generado=/ruta/carta.pdf). Guarda RUTAS o valores cortos, no contenidos largos. |
| astrax_tarea_completar_pasoB | Cierra el paso actual (exito=true) y devuelve el siguiente, o registra un fallo (exito=false). |
| astrax_tarea_limpiarA | Borra el archivo de estado y las capturas temporales (descartar o cerrar una tarea). |
| astrax_ver_pantallaA | VE la pantalla (imagen JPEG). Coordenadas 1:1 con astrax_clic; círculo rojo = cursor. Úsala para verificar el resultado de una acción, no a ciegas tras cada paso trivial. |
| astrax_capturar_pantallaA | Guarda la pantalla como PNG y devuelve su ruta (la IA no la abre; para VER usa astrax_ver_pantalla). |
| astrax_info_pantallaA | Tamaño de la pantalla en píxeles (origen arriba-izquierda). Llámala una vez. |
| astrax_clicC | Clic en (x, y), apuntando al CENTRO del elemento. boton: left|right|middle. |
| astrax_doble_clicB | Doble clic izquierdo en (x, y) (abrir archivos/iconos, seleccionar palabra). |
| astrax_escribirA | Teclea texto en el foco actual (clic antes en el campo). No-ASCII (ñ, tildes, emojis) usa el portapapeles. |
| astrax_teclaC | Pulsa una tecla (enter, esc, tab, win, backspace, f5, down...) 1-20 veces. |
| astrax_atajoA | Atajo de 2-4 teclas simultáneas, p. ej. ["ctrl","t"], ["ctrl","l"], ["alt","tab"]. |
| astrax_scrollB | Scroll vertical: positivo = arriba, negativo = abajo (-30..30). x,y opcionales (juntos). |
| astrax_esperarA | Espera 0.1-15 s (carga de apps o páginas) antes de verificar. |
| astrax_portapapelesA | Portapapeles: operacion="leer" devuelve su contenido; operacion="escribir" lo reemplaza por |
| astrax_ejecutar_comandoC | Ejecuta un comando de shell (sin entrada interactiva). Devuelve código de salida, stdout y stderr recortados. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Tools target distinct actions (key vs shortcut vs click vs double-click vs scroll), and the two screen tools are explicitly differentiated (capturar_pantalla saves PNG, ver_pantalla returns a viewable image). Minor potential confusion between astrax_tecla and astrax_atajo for single-vs-combo keys, and between astrax_clic and astrax_doble_clic, but the descriptions resolve these.
Every tool uses the same astrax_ prefix plus lowercase snake_case Spanish names, with a coherent sub-namespace (astrax_tarea_*) for the task lifecycle. The pattern is fully predictable across all 18 tools.
18 tools is slightly on the heavy side but each earns its place: input (key, shortcut, click, double-click, scroll, type), screen (capture, view, info), clipboard, shell, wait, and a six-tool task lifecycle. Scope is coherent for a desktop-automation server.
Strong coverage: keyboard, mouse, typing, clipboard, screen viewing/capture, shell execution, waiting, plus a full task create/authorize/state/save/complete/clean lifecycle. A few operations like mouse move/hover, key hold, or drag-and-drop are absent, but core RPA workflows are supported.