Há três formas de trabalhar com um projeto fora do navegador, e todas usam os mesmos arquivos, então você pode misturá-las: salvar no GitHub a partir do editor, clonar o repositório e abri-lo no VS Code, sincronizar pelo VS Code ou pelo terminal e abri-lo de novo no Mokxi.
Como é um projeto salvo
Todo salvamento no GitHub, todo mokxi pull e todo projeto que o VS Code abre tem a mesma estrutura:
| Arquivo | O que é |
|---|---|
Blink/Blink.ino |
o sketch, como uma pasta do Arduino IDE, com as outras abas ao lado |
diagram.mokxi.json |
o projeto inteiro: componentes, fios, notas e código. O Mokxi abre como está |
README.md |
o que é o projeto, com um selo Abrir no Mokxi |
.vscode/extensions.json |
recomenda a extensão do Mokxi quando a pasta abre no VS Code |
.vscode/settings.json |
de qual projeto Mokxi é a pasta |
.vscode/tasks.json |
push, pull, rodar, compilar e enviar como tarefas do VS Code |
.gitignore |
deixa de fora o estado de sincronização e a saída de compilação da linha de comando |
A pasta recebe o nome do projeto, então o Arduino IDE abre como está (File > Open > Blink/Blink.ino). Um projeto com duas placas ganha uma pasta para cada, como Traffic_Lights_uno1/ e Traffic_Lights_esp1/.
Edite o sketch na pasta, não dentro do diagram.mokxi.json: quando o Mokxi lê o repositório de volta, a pasta prevalece. Uma aba que você apagar da pasta é apagada do projeto, e um novo arquivo nela vira uma nova aba.
O README, o .gitignore e os arquivos .vscode são seus assim que existem: o Mokxi os escreve na primeira vez e não mexe nas suas edições depois disso.
Salvar no GitHub a partir do editor
- Abra Exportar no cabeçalho do editor.
- Em GitHub, aperte Conectar GitHub. O GitHub pede para você permitir que o Mokxi escreva nos seus repositórios públicos. Marque Incluir repositórios privados antes se também quiser os privados.
- De volta ao editor, abra Exportar de novo e aperte Salvar no GitHub.
- Escolha Novo repositório (o Mokxi dá o nome do projeto) ou um dos seus, escreva uma mensagem de commit se quiser e aperte Salvar no GitHub.
Você recebe um link para o commit no GitHub. Cada salvamento posterior é um novo commit no mesmo branch. A linha no topo do card diz onde você está:
- Sincronizado com ada/blink (main): o GitHub tem exatamente este projeto.
- Alterações ainda não salvas em ada/blink: você mudou o projeto desde então.
- ada/blink tem commits mais recentes: alguém fez push no repositório. Use Abrir do GitHub para pegá-los.
Abrir do GitHub
Abra Exportar e aperte Abrir do GitHub, depois escolha um dos seus repositórios ou cole qualquer repositório que você possa ler (owner/name ou um link do github.com).
- Um repositório salvo do Mokxi abre como foi salvo, com as edições feitas na pasta do sketch no GitHub ou no VS Code.
- Um repositório de sketch comum do Arduino (uma pasta com um arquivo
.ino) também abre. O Mokxi o coloca em um Uno, ou em um ESP32 quando o sketch usa WiFi. Troque a placa se ele for para outra.
O que estava aberto antes vai primeiro para a estante, como no Abrir JSON, então nada é perdido. O selo Abrir no Mokxi no README de um repositório salvo abre o projeto na hora.
Conectar e desconectar
O Mokxi pede acesso aos repositórios do GitHub só quando você aperta Conectar GitHub, nunca quando você entra. É uma permissão separada de entrar com o GitHub, e funciona do mesmo jeito se você entrar com Google, Microsoft ou e-mail.
O acesso é guardado criptografado com a sua conta e usado só quando você aperta Salvar ou Abrir. Nada mais no Mokxi o lê, e ele nunca é enviado ao seu navegador.
Para desconectar, vá em Configurações > Contas conectadas e aperte Desconectar. O Mokxi revoga o acesso no GitHub e o exclui. Fechar a sua conta faz o mesmo. Você também pode revogá-lo no GitHub, em Settings > Applications > Authorized OAuth Apps.
A sincronização com o GitHub não é oferecida a alunos em uma turma nem a contas de crianças.
VS Code
Instale o Mokxi pelo VS Code Marketplace (procure Mokxi na view de Extensões), ou pelo Open VSX no VSCodium e no Cursor. Uma pasta salva do Mokxi já o recomenda.
Rodar o circuito no VS Code
Abra uma pasta de projeto: um projeto do Mokxi, um projeto do Wokwi (wokwi.toml e diagram.json) ou um sketch. Aperte Start Simulator (o botão de play em um sketch ou no diagrama). O circuito roda em um painel ao lado do seu código, no mesmo motor do editor do Mokxi, e o terminal Mokxi Serial Monitor mostra o que as placas imprimem; digite uma linha ali e aperte Enter para enviá-la. Salvar o sketch ou o diagrama, ou uma nova compilação da sua ferramenta de build, roda de novo. Parar e Reiniciar estão na barra de título do painel e na barra de status.
Um projeto com uma compilação (o firmware indicado no wokwi.toml, uma compilação do PlatformIO ou do arduino-cli) roda essa compilação; caso contrário, o painel compila o sketch como o editor faz. Nada disso precisa de conta.
Testes, lint e CI
- Arquivos de cenário (
mokxi.test.yaml,*.test.yaml, o*.scenario.yamldo Wokwi) aparecem na view de Testes do VS Code. Cada cenário é um teste com seus passos abaixo; uma falha aponta a linha do passo, com as últimas linhas seriais. - Mokxi: Check the Circuit (Lint) coloca problemas de ligação no painel de Problemas. Ele também roda quando você salva o diagrama.
- Mokxi: Screenshot a Display salva um display como PNG no momento que você escolher.
- Mokxi: Set Up CI (GitHub Actions ou GitLab) escreve o workflow, o arquivo de CI do GitLab, ou ambos, e um primeiro
mokxi.test.yamlse o projeto não tiver nenhum. Veja testes de simulação no CI.
Seus projetos do Mokxi
- Clique no ícone do Mokxi na Activity Bar e aperte Entrar. Aprove o código curto no seu navegador, ou cole um token de Configurações > Desenvolvedor.
- Seus projetos aparecem na barra lateral. Clique em um para abri-lo como pasta.
- Edite o sketch. Arquivos
.inoganham destaque de sintaxe do Arduino, além de trechos comosketch,blink,buttoneevery. - Aperte Sync (a nuvem na barra de título do editor) para enviá-lo ao Mokxi.
- Open in Mokxi (o item do Mokxi na barra de status) abre o projeto no editor no seu navegador.
O Sync se recusa a sobrescrever trabalho feito no navegador desde sua última sincronização, e o Pull se recusa a descartar edições que você não sincronizou. Cada um explica o motivo e deixa você escolher. Abrir, sincronizar, fazer pull e fazer upload fazem parte do Pro.
Compilar e enviar
Mokxi: Compile (arduino-cli) usa o arduino-cli se você o tiver, com erros no painel de Problemas, e Mokxi: Compile and Upload to Mokxi sincroniza, compila e guarda a compilação com o projeto, então o mokxi.com roda exatamente o que você compilou. Você não precisa do arduino-cli para o painel do simulador, que compila o sketch por conta própria.
A linha de comando
As mesmas coisas funcionam em um terminal com npx @mokxi/cli. Veja
A linha de comando mokxi.
npx @mokxi/cli login
npx @mokxi/cli pull https://mokxi.com/p/abc123 blink
cd blink && git init
npx @mokxi/cli push
npx @mokxi/cli run --timeout 5s
Quais planos
GitHub sync and the command line are on every plan. mokxi run and mokxi test compile and simulate on your own machine, so they are free and need no
sign-in. In VS Code, the simulator panel, tests, lint, screenshots, Set Up CI
and Compile are free and need no account too. Your Mokxi projects in VS
Code (opening, Sync, Pull and Compile and Upload to Mokxi) are part of Pro
(and the student price and Classroom); without it, the extension says
so and offers the 7-day Pro trial where you can still start it. CI runs (the GitHub
Action, or the command line tool in a CI job) are free for public
repositories; for private ones, CI comes with Pro (and the student price,
Classroom, the trial, Lifetime, and Ultra for accounts that still have it); see testes de simulação no CI. If you used either in the 60 days before
October 12, 2026, you keep it until December 11, 2026, and the tool tells you
so. mokxi run --cloud and mokxi simulate run on Mokxi's servers and use the
API minutes your plan includes; the developers page lists them.