El cambio de dos líneas
En GitHub Actions, cambia la línea uses: y el secreto que lee la entrada token. Todo lo demás del paso se queda igual.
- uses: actions/checkout@v4
-- uses: wokwi/wokwi-ci-action@v1
+- uses: mokxiorg/sim-action@v1
with:
- token: ${{ secrets.WOKWI_CLI_TOKEN }}
+ token: ${{ secrets.MOKXI_TOKEN }}
path: .
timeout: 10000
scenario: test.scenario.yaml
expect_text: Ready
fail_text: panic
serial_log_file: serial.log
A public repository needs no token: Mokxi CI is free for it, so you can delete the token: line. For a private one, CI comes with Pro (and the student price, Lifetime, Classroom and the trial; an account that still has Ultra keeps it too), so you need a CI token from a Pro account. Make the token under Settings > Developer, and save it as a repository secret named MOKXI_TOKEN. The action passes it to the command line tool, which checks your plan with it. Until December 11, 2026 everybody keeps CI and each run prints a notice.
La acción acepta los nombres de entrada de Wokwi (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) con los significados de Wokwi: un timeout solo está en milisegundos, path: / es la raíz del repositorio, scenario se lee relativo a la carpeta del proyecto y args es una línea de opciones separadas por espacios.
Desde una terminal, wokwi-cli <dir> se convierte en npx @mokxi/cli run <dir>, y las opciones conservan sus nombres (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).
Lo que se ejecuta sin cambios
- Archivos del proyecto.
diagram.json, el sketch y sus pestañas,libraries.txtywokwi.toml. Cuandowokwi.tomlnombra un archivo de firmware que existe (una compilación de PlatformIO, ESP-IDF, arduino-cli o Rust), esa compilación se ejecuta, igual que en Wokwi. Cuando no existe, Mokxi compila el sketch por sí mismo, así que un repositorio con solo código fuente también funciona. - Pasos de escenario.
wait-serial,write-serial(texto o una lista de bytes),delay,set-control,expect-pin(conpinycontrol, o la clave más recientename),take-screenshotconsave-toycompare-with, ytouch,touch-press,touch-moveytouch-releaseen los paneles táctiles ILI9341. - Ids de componentes. Un paso nombra un componente por su id en tu
diagram.json.
Tres cosas se comportan diferente:
- El código de salida por defecto para un timeout es 1. El de Wokwi es 42. Usa
timeout_exit_code: 42(o--timeout-exit-code 42) si tu flujo de trabajo lo verifica. - Las placas tipo Uno tardan 65 ms en iniciar. La Uno, la Nano y otras placas ATmega modelan el retraso de arranque del chip al encender, así que un pin verificado en los primeros 70 ms más o menos de una ejecución se lee distinto que en Wokwi. Comienza un escenario con
delay: 100mso unwait-serial. - Las capturas de todo el circuito son SVG. Una captura de un componente de pantalla (un OLED, un TFT, una LCD de caracteres, tinta electrónica o una pantalla Nokia) es un PNG de los píxeles del propio panel, y
compare-withla compara con tu referencia píxel por píxel. Una captura de cualquier otro componente es un dibujo SVG, ycompare-withno se verifica para él. Toma tus imágenes de referencia de nuevo con Mokxi: la primera ejecución de uncompare-withsin archivo de referencia guarda ahí su imagen para que la revises y la confirmes.
Un componente de Wokwi sin equivalente en Mokxi se deja fuera y se nombra en el registro, igual que al importar el proyecto al editor. Importar desde otras herramientas lista lo que sí pasa.
Cómo se comparan
| Mokxi | Wokwi CI | |
|---|---|---|
| Dónde se ejecuta la simulación | En tu ejecutor de CI | En los servidores de Wokwi |
| Compila el sketch en CI | Sí, con el propio compilador del editor, con caché | No, primero lo compilas tú |
| CI gratis | Repositorios públicos, sin límite de ejecuciones (corren en tu runner) | Unos 50 minutos de CI al mes (según la documentación de Wokwi, verificado el 26-10-2026) |
| CI de pago | Repositorios privados con Pro; sin conteo de minutos en tu runner | Pro, from one seat, 2,000 CI minutes a month |
| Archivos de escenario de Wokwi | Sí, sin cambios | Sí |
| Pasos adicionales | press, click, set, wait-pin, expect-toggles (tiempos), expect-led, expect-probe, expect-display |
|
| Verificaciones de pantalla | expect-display (píxeles encendidos, una región, un píxel, en blanco) y PNG compare-with |
PNG compare-with |
| Reporte JUnit | Sí | No aparece en la documentación de Wokwi |
| Resumen del trabajo y anotaciones | Sí: una tabla de resultados, cada falla en la línea del escenario con las últimas líneas de la salida serie | No aparece en la documentación de Wokwi |
| Analizador lógico a VCD | --vcd-file |
--vcd-file |
| Tiempo simulado y tiempo real | Se reporta en cada ejecución | |
| Se reparte entre trabajos | --shard 1/3 |
|
| Otro CI (GitLab, Jenkins, CircleCI) | Sí, cualquier máquina con Node 18 | Sí |
| Revisión de diagramas | mokxi lint |
wokwi-cli lint |
| Monitoreo del heap de ESP-IDF | Not yet | Sí |
| Imágenes de tarjeta SD | Not yet | Sí |
| Servidor GDB | Not yet | Sí |
| Cobertura de código | Not yet | Sí |
| Los chips personalizados | Not yet | Sí |
| Escribir por stdin durante una ejecución | Not yet | --interactive |
Precios
Running mokxi run and mokxi test on your own computer is free, with no account. CI is free for public repositories on GitHub and gitlab.com, with no limit on runs: they run on your runner, not ours. A private repository comes with Pro, with 2,000 API minutes a month for mokxi simulate and mokxi run --cloud (an account that still has Ultra keeps CI and its 5,000 minutes).
Wokwi Pro cuesta EUR 25 por lugar al mes, o EUR 20 al mes con cobro anual (según wokwi.com/pricing, verificado el 26-10-2026).
Consulta Pruebas de simulación en CI para la referencia completa de comandos y escenarios.