Hay tres formas de trabajar con un proyecto fuera del navegador, y todas usan los mismos archivos, así que puedes combinarlas: guardar en GitHub desde el editor, clonar el repositorio y abrirlo en VS Code, sincronizar desde VS Code o la terminal, y volver a abrirlo en Mokxi.
Cómo se ve un proyecto guardado
Cada guardado en GitHub, cada mokxi pull y cada proyecto que abre VS Code tienen la misma estructura:
| Archivo | Qué es |
|---|---|
Blink/Blink.ino |
el sketch, como una carpeta del IDE de Arduino, con sus otras pestañas junto a él |
diagram.mokxi.json |
el proyecto completo: componentes, cables, notas y código. Mokxi lo abre tal cual |
README.md |
qué es el proyecto, con una marca de Abrir en Mokxi |
.vscode/extensions.json |
recomienda la extensión de Mokxi cuando la carpeta se abre en VS Code |
.vscode/settings.json |
de qué proyecto de Mokxi es la carpeta |
.vscode/tasks.json |
push, pull, ejecutar, compilar y cargar como tareas de VS Code |
.gitignore |
omite el estado de sincronización y la salida de compilación de la línea de comandos |
La carpeta toma el nombre del proyecto, así que el IDE de Arduino la abre tal cual (Archivo > Abrir > Blink/Blink.ino). Un proyecto con dos placas obtiene una carpeta por cada una, como Traffic_Lights_uno1/ y Traffic_Lights_esp1/.
Edita el sketch en la carpeta, no dentro de diagram.mokxi.json: cuando Mokxi vuelve a leer el repositorio, la carpeta gana. Una pestaña que borres de la carpeta se borra del proyecto, y un archivo nuevo en ella se convierte en una pestaña nueva.
El README, el .gitignore y los archivos de .vscode son tuyos una vez que existen: Mokxi los escribe la primera vez y después respeta tus ediciones.
Guardar en GitHub desde el editor
- Abre Exportar en el encabezado del editor.
- En GitHub, presiona Conectar GitHub. GitHub te pide que permitas a Mokxi escribir en tus repositorios públicos. Marca primero Incluir repositorios privados si también quieres los privados.
- De vuelta en el editor, abre Exportar de nuevo y presiona Guardar en GitHub.
- Elige Repositorio nuevo (Mokxi lo nombra como el proyecto) o uno tuyo, escribe un mensaje de commit si quieres, y presiona Guardar en GitHub.
Recibes un enlace al commit en GitHub. Cada guardado posterior es un commit nuevo en la misma rama. La línea en la parte superior de la tarjeta te dice dónde estás:
- Sincronizado con ada/blink (main): GitHub tiene exactamente este proyecto.
- Cambios aún no guardados en ada/blink: cambiaste el proyecto desde entonces.
- ada/blink tiene commits más recientes: alguien hizo push al repositorio. Usa Abrir desde GitHub para obtenerlos.
Abrir desde GitHub
Abre Exportar y presiona Abrir desde GitHub, luego elige uno de tus repositorios o pega cualquier repositorio que puedas leer (owner/name o un enlace de github.com).
- Un repositorio guardado desde Mokxi se abre tal como se guardó, con cualquier edición hecha a la carpeta del sketch en GitHub o en VS Code.
- Un repositorio de sketch de Arduino normal (una carpeta con un archivo
.ino) también se abre. Mokxi lo pone en una Uno, o en una ESP32 cuando el sketch incluye WiFi. Cambia la placa si es para otra.
Lo que estaba abierto antes pasa primero al estante, como con Abrir JSON, así que no se pierde nada. La marca de Abrir en Mokxi en el README de un repositorio guardado abre el proyecto de inmediato.
Conectar, y desconectar
Mokxi le pide a GitHub acceso a repositorios solo cuando presionas Conectar GitHub, nunca cuando inicias sesión. Es un permiso aparte de iniciar sesión con GitHub, y funciona igual si inicias sesión con Google, Microsoft o correo electrónico.
El acceso se guarda cifrado con tu cuenta y se usa solo cuando presionas Guardar o Abrir. Nada más en Mokxi lo lee, y nunca se envía a tu navegador.
Para desconectar, ve a Configuración > Cuentas conectadas y presiona Desconectar. Mokxi revoca su acceso en GitHub y lo elimina. Cerrar tu cuenta hace lo mismo. También puedes revocarlo en GitHub, en Settings > Applications > Authorized OAuth Apps.
La sincronización con GitHub no se ofrece a estudiantes de una clase ni a cuentas de niños.
VS Code
Instala Mokxi desde el VS Code Marketplace (busca Mokxi en la vista de Extensiones), o desde Open VSX en VSCodium y Cursor. Una carpeta guardada desde Mokxi ya lo recomienda.
Ejecutar el circuito en VS Code
Abre una carpeta de proyecto: un proyecto de Mokxi, un proyecto de Wokwi (wokwi.toml y diagram.json) o un sketch. Presiona Iniciar simulador (el botón de reproducir en un sketch o en el diagrama). El circuito se ejecuta en un panel junto a tu código, con el mismo motor que el editor de Mokxi, y la terminal del Monitor serie de Mokxi muestra lo que imprimen las placas; escribe una línea ahí y presiona Enter para enviarla. Guardar el sketch o el diagrama, o una compilación nueva de tu herramienta de compilación, lo vuelve a ejecutar. Detener y Reiniciar están en la barra de título del panel y en la barra de estado.
Un proyecto con una compilación (el firmware que nombra wokwi.toml, una compilación de PlatformIO o de arduino-cli) ejecuta esa compilación; de lo contrario, el panel compila el sketch como lo hace el editor. Nada de esto necesita una cuenta.
Pruebas, lint y CI
- Los archivos de escenarios (
mokxi.test.yaml,*.test.yaml, los*.scenario.yamlde Wokwi) aparecen en la vista de Testing de VS Code. Cada escenario es una prueba con sus pasos debajo; un fallo señala la línea del paso, con las últimas líneas serie. - Mokxi: Revisar el circuito (Lint) pone los problemas de cableado en el panel de Problemas. También se ejecuta al guardar el diagrama.
- Mokxi: Capturar una pantalla guarda una pantalla como PNG en el momento que elijas.
- Mokxi: Configurar CI (GitHub Actions o GitLab) escribe el flujo de trabajo, el archivo de CI de GitLab, o ambos, y una primera
mokxi.test.yamlsi el proyecto no tiene ninguno. Consulta las pruebas de simulación en CI.
Tus proyectos de Mokxi
- Haz clic en el ícono de Mokxi en la barra de actividad y presiona Iniciar sesión. Aprueba el código corto en tu navegador, o pega un token desde Configuración > Developer.
- Tus proyectos aparecen en la barra lateral. Haz clic en uno para abrirlo como carpeta.
- Edita el sketch. Los archivos
.inoobtienen resaltado de Arduino, así como fragmentos comosketch,blink,buttonyevery. - Presiona Sync (la nube en la barra de título del editor) para enviarlo a Mokxi.
- Abrir en Mokxi (el elemento de Mokxi en la barra de estado) lo abre en el editor de tu navegador.
Sync se niega a sobrescribir el trabajo hecho en el navegador desde tu última sincronización, y Pull se niega a descartar ediciones que no has sincronizado. Cada uno te dice por qué y te deja elegir. Abrir, sincronizar, hacer pull y subir archivos son parte de Pro.
Compilar y cargar
Mokxi: Compile (arduino-cli) usa arduino-cli si lo tienes, con errores en el panel de problemas, y Mokxi: Compile and Upload to Mokxi sincroniza, compila y guarda la compilación con el proyecto, de modo que mokxi.com ejecuta exactamente lo que compilaste. No necesitas arduino-cli para el panel del simulador, que compila un sketch por sí mismo.
La línea de comandos
Lo mismo funciona desde una terminal con npx @mokxi/cli. Consulta
La línea de comandos 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
Qué planes
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 las pruebas de simulación en 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.