El lenguaje para
automatizar tu PC

Controla ratón, teclado, ventanas y Chrome con una sintaxis que se lee sola. Escrito en Rust, con salida JSON para agentes de IA y modo simulación.

Leer la documentación Ver en GitHub

demo.acm

Salida

acm>

El IDE de escritorio de acm, aquí en una versión interactiva: edita, ejecuta con F5 o simula con Ctrl F5. En tu PC, el IDE lanza el acm real.

Todo lo que necesitas
para automatizar tu PC

CLICK 70 220MOVE 300 80

CTRL+SHIFT+T

Ratón y teclado →

Clics, arrastres, rueda y texto Unicode. Combinaciones como CTRL + SHIFT + T y repeticiones con (N).

example.com/login

#useranthoni

//input[@id='pass']•••••••

Entrar

Chrome sin WebDriver →

Chrome, Edge o Brave por DevTools. Selectores CSS o XPath y esperas automáticas de hasta 10 s.

Hecho para agentes de IA →

Con --json cada línea es un evento. Códigos de salida fiables: 0, 1, 2 y 130.

dryOPEN "notepad.exe"

dryWRITE "Hola"

dryKEY CTRL + A

drySCREENSHOT "a.png"

Simula antes de ejecutar →

--dry-run recorre el script sin mover el ratón, teclear ni abrir nada. -c solo comprueba la sintaxis.

Lista de IPs

IP base192.168.1Protocolohttps ▾Incluir puerto

Ejecutar

Extensiones .acmx →

Las directivas @ARG convierten un script en una herramienta con formulario y argumentos tipados.

0,0exit 130

Parada de emergencia →

Lleva el ratón a la esquina superior izquierda y el script se detiene antes de la siguiente acción.

Variables, funciones y bucles →

VAR, FUNC, IF, FOR … IN, WHILE y LOOP, con interpolación ${…} de cualquier expresión.

Ventanas y procesos →

FOCUS, WAITWINDOW, OPEN y EXEC -> var. windows() y activewindow() listan lo que hay abierto.

Capturas y píxeles →

SCREENSHOT de la pantalla o de una región y pixel(x, y) para leer colores. En píxeles físicos, aunque escales al 150 %.

Portapapeles y archivos →

PASTE restaura tu portapapeles. WRITEFILE, APPENDFILE, read(), listdir() y parsejson().

Consola interactiva →

acm sin argumentos abre un REPL. Con -i entras en él al terminar el script, con sus variables cargadas.

IDE de escritorio →

Editor con resaltado, autocompletado, errores en vivo con acm -c, F5 para ejecutar y Ctrl+F5 para simular.

Se lee como
lo dirías

Sin clases, sin imports, sin async. Un script de acm es la lista de cosas que harías tú con el ratón y el teclado, con variables, funciones y bucles cuando los necesitas.

Una sentencia por línea: Varias en la misma línea separadas por ;. Comentarios con // o #.
Comandos en cualquier capitalización: click es CLICK. Las variables sí distinguen mayúsculas.
Textos que interpolan: "${i * 2}", "${upper(x)}" o "${ips[i]}". Las rutas C:\ no necesitan escapes.
Repite sin bucles: KEYPRESS TAB (3) o WRITE "=" (40) repiten un comando N veces.

examples/notepad.acm · Abre el Bloc de notas, escribe, copia y comprueba el texto.

// Abre el Bloc de notas, escribe, y comprueba lo escrito a través del portapapeles.
// Lleva el ratón a la esquina superior izquierda para abortar (FAILSAFE).
// Ejecutar:  acm examples/notepad.acm

OPEN "notepad.exe"
WAITWINDOW "Bloc de notas", 10000
FOCUS "Bloc de notas"
DELAY 500ms

WRITE "Escrito por acm el ${now()}"
KEYPRESS ENTER
PASTE "Esta línea se pegó desde el portapapeles."
KEYPRESS ENTER
FOR i = 1 TO 3
    WRITE "Línea ${i} de 3"
    KEYPRESS ENTER
NEXT

// Seleccionar todo y copiar para verificar
KEYPRESS CTRL + A
KEYPRESS CTRL + C
DELAY 200ms
VAR texto = clipboard()
ASSERT contains(texto, "Línea 3 de 3"), "el texto no llegó al Bloc de notas"
PRINT "OK: el Bloc de notas contiene", len(lines(texto)), "líneas"
SCREENSHOT "notepad.png"
NOTIFY "Prueba del Bloc de notas completada"

examples/prueba_web.acm · Prueba E2E de un login en Chrome sin ventana.

// Prueba web automatizada (estilo test E2E) con Chrome sin ventana.
// Ejecutar:  acm examples/prueba_web.acm        (o con --json para agentes)

WEBBROWSER CHROME HEADLESS
WEBOPEN "data:text/html,<h1 id='titulo'>Login</h1><input id='user'><input id='pass' type='password'><label><input type='checkbox' id='rec'>Recordar</label><button id='go' onclick=\"document.getElementById('titulo').innerText='Bienvenido '+document.getElementById('user').value\">Entrar</button>"

WEBINPUT "#user" "anthoni"
WEBINPUT "//input[@id='pass']" "secreto"
WEBCHECK "#rec" TRUE
WEBCLICK "#go"

WEBGET "#titulo" titulo
ASSERT titulo == "Bienvenido anthoni", "login fallido: '${titulo}'"
ASSERT webjs("document.getElementById('rec').checked") == TRUE

WEBSCREENSHOT "prueba_web.png"
PRINT "PASS:", titulo

examples/hola.acm · Variables, funciones, listas y datos del escritorio.

// Ejemplo básico: no toca el ratón ni el teclado.
// Ejecutar:  acm examples/hola.acm nombre=Ana

IF EMPTY nombre
    VAR nombre = "mundo"
ENDIF
PRINT "Hola, ${nombre}! Estás en ${OS}, pantalla ${screenwidth()}x${screenheight()}"

FUNC ip(base, n)
    RETURN base + "." + n
ENDFUNC

VAR ips = []
FOR i = 1 TO 5
    ips = push(ips, ip("192.168.1", i))
NEXT
PRINT "IPs:", join(ips, " | ")

VAR ventanas = windows()
PRINT "Hay ${ventanas.length} ventanas abiertas. La activa es: ${activewindow()}"
PRINT "Ratón en", mousex(), mousey(), "color bajo el cursor:", pixel(mousex(), mousey())

Chrome, Edge y Brave.
Sin WebDriver.

El navegador se abre con el primer comando web y se controla por el protocolo DevTools. Pruebas E2E en diez líneas, con o sin ventana.

WEBBROWSER CHROME HEADLESS
WEBOPEN "https://example.com/login"

WEBINPUT "#user" "anthoni"
WEBINPUT "//input[@id='pass']" "secreto"
WEBCHECK "#rec" TRUE
WEBCLICK "#go"

WEBGET "#titulo" titulo
ASSERT titulo == "Bienvenido anthoni"
WEBSCREENSHOT "prueba_web.png"

Captura tomada por acm: la página dice Bienvenido anthoni con el formulario de login relleno — Captura real tomada por WEBSCREENSHOT al ejecutar examples/prueba_web.acm.

CSS o XPath
Si el selector empieza por / o ( es XPath; si no, CSS.
Esperas automáticas
Cada comando espera al elemento hasta 10 s. WEBWAIT espera a VISIBLE, HIDDEN, CLICKABLE o GONE.
Perfiles persistentes
WEBPROFILE "carpeta" conserva las sesiones iniciadas entre ejecuciones.
≈ 2 ms por llamada
acm incluye una copia parcheada de headless_chrome: cada llamada bajó de unos 100 ms a unos 2 ms.

Hecho para que lo use
un agente de IA

Pídele a tu agente que escriba un .acm, lo compruebe, lo simule y lo ejecute.Salida estructurada, sin ventanas que bloqueen y códigos fiables: todo lo que necesita para saber qué pasó.

Terminal

$ acm --json -v --no-dialogs examples/prueba_web.acm
{"event":"start","script":"examples\\prueba_web.acm","statements":11}
{"event":"step","line":7,"code":"WEBINPUT \"#user\" \"anthoni\""}
{"event":"step","line":10,"code":"WEBCLICK \"#go\""}
{"event":"screenshot","path":"C:\\…\\prueba_web.png"}
{"event":"print","text":"PASS: Bienvenido anthoni"}
{"event":"done","ok":true,"code":0,"ms":2755}

$ acm --dry-run --json examples/notepad.acm
{"event":"start","script":"examples\\notepad.acm","statements":17}
{"event":"dry","line":5,"action":"OPEN \"notepad.exe\""}
{"event":"dry","line":6,"action":"WAITWINDOW \"Bloc de notas\" 10000ms"}
{"event":"dry","line":11,"action":"KEY ENTER (Tap)"}
{"event":"dry","line":20,"action":"KEY CTRL + A (Tap)"}
{"event":"dry","line":26,"action":"SCREENSHOT \"notepad.png\""}
{"event":"done","ok":true,"code":0,"ms":31}

$ acm -c examples/prueba_web.acm
OK: examples\prueba_web.acm — sintaxis correcta (11 sentencias)

$ acm -e 'CLIK 10 20'
error (línea 1): error de sintaxis: comando desconocido 'CLIK'
exit code 2

0     todo correcto
1     error en tiempo de ejecución
2     error de sintaxis o de argumentos
130   cancelado con Ctrl+C o por FAILSAFE
N     el script ejecutó EXIT N

Empieza en un minuto

Guía de instalación Descargar binarios

1
Instala acm
En PowerShell. Deja acm.exe en %LOCALAPPDATA%\Programs\acm\bin y lo añade al PATH. No necesitas Rust.
En la Terminal. Deja acm en ~/.local/bin. Después concede a la terminal Accesibilidad y Grabación de pantalla.
En una sesión X11. Deja acm en ~/.local/bin; si esa carpeta no está en el PATH, el instalador te dice cómo añadirla.
2
Comprueba la instalación
Abre una terminal nueva para que se cargue el PATH actualizado.
3
Ejecuta tu primer script
Como python: un archivo, código suelto con -e o la consola interactiva.

Windows x64macOS Intel y Apple SiliconLinux x64 (X11)·Navegador: Chrome, Edge o Brave·¿Prefieres compilarlo? cargo install --path .

El lenguaje paraautomatizar tu PC

Todo lo que necesitaspara automatizar tu PC

Ratón y teclado →

Chrome sin WebDriver →

Hecho para agentes de IA →

Simula antes de ejecutar →

Extensiones .acmx →

Parada de emergencia →

Variables, funciones y bucles →

Ventanas y procesos →

Capturas y píxeles →

Portapapeles y archivos →

Consola interactiva →

IDE de escritorio →

Se lee comolo dirías

Chrome, Edge y Brave.Sin WebDriver.

CSS o XPath

Esperas automáticas

Perfiles persistentes

≈ 2 ms por llamada

Hecho para que lo useun agente de IA

Empieza en un minuto

Instala acm

Comprueba la instalación

Ejecuta tu primer script

El lenguaje para
automatizar tu PC

Todo lo que necesitas
para automatizar tu PC

Se lee como
lo dirías

Chrome, Edge y Brave.
Sin WebDriver.

Hecho para que lo use
un agente de IA