A mudança de duas linhas
No GitHub Actions, mude a linha uses: e o secret que a entrada token lê. Todo o resto do passo fica como está.
- 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.
A action aceita os nomes de entrada do Wokwi (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) com os significados do Wokwi: um timeout sozinho é em milissegundos, path: / é a raiz do repositório, scenario é lido em relação à pasta do projeto, e args é uma linha de opções separadas por espaços.
De um shell, wokwi-cli <dir> vira npx @mokxi/cli run <dir>, e as opções mantêm seus nomes (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).
O que roda sem mudanças
- Arquivos do projeto.
diagram.json, o sketch e suas abas,libraries.txtewokwi.toml. Quando owokwi.tomlaponta um arquivo de firmware que existe (um build do PlatformIO, ESP-IDF, arduino-cli ou Rust), esse build é executado, como o Wokwi faz. Quando ele não existe, o Mokxi compila o sketch por conta própria, então um repositório só com código-fonte também funciona. - Passos de cenário.
wait-serial,write-serial(texto ou uma lista de bytes),delay,set-control,expect-pin(compinecontrol, ou a chave mais novaname),take-screenshotcomsave-toecompare-with, etouch,touch-press,touch-moveetouch-releasenos painéis de toque ILI9341. - Ids de componentes. Um passo nomeia um componente pelo seu id no seu
diagram.json.
Três coisas se comportam de forma diferente:
- O código de saída padrão para um timeout é 1. O do Wokwi é 42. Defina
timeout_exit_code: 42(ou--timeout-exit-code 42) se seu workflow verifica isso. - Placas nível Uno levam 65 ms para iniciar. A Uno, a Nano e outras placas ATmega modelam o atraso de inicialização do chip ao ligar, então um pino verificado nos primeiros 70 ms ou mais de uma execução lê um valor diferente do Wokwi. Comece um cenário com
delay: 100msou umwait-serial. - Capturas de tela do circuito inteiro são SVG. Uma captura de um componente de display (um OLED, um TFT, um LCD de caracteres, e-paper ou uma tela Nokia) é um PNG dos próprios pixels do painel, e o
compare-witho confere com sua referência pixel a pixel. Uma captura de qualquer outro componente é um desenho SVG, e ocompare-withnão é verificado nesse caso. Tire suas imagens de referência de novo com o Mokxi: a primeira execução de umcompare-withsem arquivo de referência salva a imagem lá para você conferir e fazer commit.
Um componente do Wokwi sem equivalente no Mokxi é deixado de fora e citado no log, igual a quando você importa o projeto para o editor. Importando de outras ferramentas lista o que é trazido.
Como eles se comparam
| Mokxi | Wokwi CI | |
|---|---|---|
| Onde a simulação roda | No seu runner de CI | Nos servidores do Wokwi |
| Compila o sketch no CI | Sim, com o próprio compilador do editor, em cache | Não, você compila antes |
| CI grátis | Repositórios públicos, sem limite de execuções (elas rodam no seu runner) | Cerca de 50 minutos de CI por mês (segundo a docs do Wokwi, verificado em 26/10/2026) |
| CI pago | Repositórios privados com Pro; sem contagem de minutos no seu runner | Pro, from one seat, 2,000 CI minutes a month |
| Arquivos de cenário do Wokwi | Sim, sem mudanças | Sim |
| Passos extras | press, click, set, wait-pin, expect-toggles (temporização), expect-led, expect-probe, expect-display |
|
| Verificações de display | expect-display (pixels acesos, uma região, um pixel, em branco) e PNG compare-with |
PNG compare-with |
| Relatório JUnit | Sim | Não está na docs do Wokwi |
| Resumo do job e anotações | Sim: uma tabela de resultados, cada falha na linha do cenário com as últimas linhas da saída serial | Não está na docs do Wokwi |
| Analisador lógico para VCD | --vcd-file |
--vcd-file |
| Tempo simulado e tempo real | Reportado a cada execução | |
| Dividido entre jobs | --shard 1/3 |
|
| Outros CI (GitLab, Jenkins, CircleCI) | Sim, qualquer máquina com Node 18 | Sim |
| Lint de diagrama | mokxi lint |
wokwi-cli lint |
| Monitoramento de heap do ESP-IDF | Not yet | Sim |
| Imagens de cartão SD | Not yet | Sim |
| Servidor GDB | Not yet | Sim |
| Cobertura de código | Not yet | Sim |
| Chips personalizados | Not yet | Sim |
| Digitar em uma execução pelo stdin | Not yet | --interactive |
Preços
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).
O Wokwi Pro custa EUR 25 por vaga por mês, ou EUR 20 por mês cobrados anualmente (segundo wokwi.com/pricing, verificado em 26/10/2026).
Veja Testes de simulação no CI para a referência completa de comandos e cenários.