Ada tiga cara untuk mengerjakan proyek di luar browser, dan semuanya memakai file yang sama, jadi kamu bisa mencampurnya: simpan ke GitHub dari editor, clone repositori dan buka di VS Code, sinkronkan dari VS Code atau terminal, lalu buka lagi di Mokxi.
Bentuk proyek yang tersimpan
Setiap simpanan ke GitHub, setiap mokxi pull, dan setiap proyek yang dibuka VS Code punya tata letak yang sama:
| File | Apa ini |
|---|---|
Blink/Blink.ino |
sketch-nya, sebagai folder Arduino IDE, dengan tab lainnya di sampingnya |
diagram.mokxi.json |
seluruh proyek: komponen, kabel, catatan, dan kode. Mokxi membukanya apa adanya |
README.md |
apa proyeknya, dengan lencana Buka di Mokxi |
.vscode/extensions.json |
menyarankan ekstensi Mokxi saat folder dibuka di VS Code |
.vscode/settings.json |
folder ini adalah proyek Mokxi yang mana |
.vscode/tasks.json |
push, pull, jalankan, kompilasi, dan upload sebagai task VS Code |
.gitignore |
tidak memuat status sinkronisasi dan output build dari command line |
Folder mengambil nama proyek, jadi Arduino IDE membukanya apa adanya (File > Open > Blink/Blink.ino). Proyek dengan dua board mendapat satu folder untuk masing-masing, seperti Traffic_Lights_uno1/ dan Traffic_Lights_esp1/.
Edit sketch di folder tersebut, bukan di dalam diagram.mokxi.json: saat Mokxi membaca kembali repositori, folder yang menang. Tab yang kamu hapus dari folder akan terhapus dari proyek, dan file baru di dalamnya menjadi tab baru.
README, .gitignore dan file .vscode jadi milikmu begitu ada: Mokxi menulisnya pertama kali dan membiarkan editanmu setelah itu.
Simpan ke GitHub dari editor
- Buka Export di header editor.
- Di bawah GitHub, tekan Connect GitHub. GitHub memintamu mengizinkan Mokxi menulis ke repositori publikmu. Centang Include private repositories dulu jika kamu juga mau yang privat.
- Kembali di editor, buka Export lagi dan tekan Save to GitHub.
- Pilih New repository (Mokxi menamainya sesuai proyek) atau salah satu milikmu, tulis pesan commit jika mau, lalu tekan Save to GitHub.
Kamu mendapat link ke commit di GitHub. Setiap simpanan berikutnya adalah commit baru di branch yang sama. Baris di bagian atas kartu menunjukkan posisimu:
- Synced with ada/blink (main): GitHub punya proyek ini persis.
- Changes not saved to ada/blink yet: kamu mengubah proyek sejak itu.
- ada/blink has newer commits: seseorang push ke repositori. Gunakan Open from GitHub untuk mengambilnya.
Buka dari GitHub
Buka Export dan tekan Open from GitHub, lalu pilih salah satu repositori milikmu atau tempel repositori apa pun yang bisa kamu baca (owner/name atau link github.com).
- Repositori yang disimpan dari Mokxi akan terbuka seperti saat disimpan, termasuk semua perubahan pada folder sketch di GitHub atau di VS Code.
- Repositori sketch Arduino biasa (folder dengan file
.ino) juga bisa dibuka. Mokxi memasangnya di Uno, atau di ESP32 jika sketch-nya memakai WiFi. Ganti board jika sketch-nya memang untuk board lain.
Proyek yang sebelumnya terbuka akan disimpan di rak dulu, seperti pada Buka JSON, jadi tidak ada yang hilang. Lencana Buka di Mokxi di README repositori yang disimpan langsung membuka proyeknya.
Menyambungkan, dan memutuskan
Mokxi meminta akses repositori ke GitHub hanya saat kamu menekan Connect GitHub, tidak pernah saat kamu masuk. Itu izin terpisah dari masuk dengan GitHub, dan cara kerjanya sama baik kamu masuk dengan Google, Microsoft, atau email.
Aksesnya disimpan terenkripsi bersama akunmu dan hanya dipakai saat kamu menekan Simpan atau Buka. Tidak ada bagian lain dari Mokxi yang membacanya, dan tidak pernah dikirim ke browser-mu.
Untuk memutuskan, buka Setelan > Akun tersambung dan tekan Putuskan. Mokxi mencabut aksesnya di GitHub dan menghapusnya. Menutup akunmu juga melakukan hal yang sama. Kamu juga bisa mencabutnya di GitHub, di Settings > Applications > Authorized OAuth Apps.
Sinkronisasi GitHub tidak ditawarkan kepada siswa dalam kelas atau akun anak-anak.
VS Code
Pasang Mokxi dari VS Code Marketplace (cari Mokxi di tampilan Extensions), atau dari Open VSX di VSCodium dan Cursor. Folder yang disimpan dari Mokxi sudah merekomendasikannya.
Jalankan rangkaian di VS Code
Buka folder proyek: proyek Mokxi, proyek Wokwi (wokwi.toml dan diagram.json), atau sketch. Tekan Start Simulator (tombol play pada sketch atau diagram). Rangkaian berjalan di panel di samping kodemu, dengan engine yang sama seperti editor Mokxi, dan terminal Mokxi Serial Monitor menampilkan apa yang dicetak board; ketik satu baris di sana dan tekan Enter untuk mengirimnya. Menyimpan sketch atau diagram, atau build baru dari alat build-mu, akan menjalankannya lagi. Hentikan dan Restart ada di bilah judul panel dan di status bar.
Proyek dengan build (firmware yang disebut wokwi.toml, build PlatformIO, atau build arduino-cli) menjalankan build tersebut; jika tidak, panel mengompilasi sketch seperti yang dilakukan editor. Semua ini tidak butuh akun.
Tes, lint, dan CI
- File skenario (
mokxi.test.yaml,*.test.yaml, atau*.scenario.yamlmilik Wokwi) muncul di tampilan Testing VS Code. Setiap skenario adalah tes dengan langkah-langkahnya di bawahnya; kegagalan menunjuk ke baris langkah tersebut, beserta baris serial terakhir. - Mokxi: Check the Circuit (Lint) menaruh masalah kabel di panel Problems. Ini juga berjalan saat kamu menyimpan diagram.
- Mokxi: Screenshot a Display menyimpan tampilan layar sebagai PNG pada saat kamu pilih.
- Mokxi: Set Up CI (GitHub Actions atau GitLab) menulis workflow, file GitLab CI, atau keduanya, dan sebuah
mokxi.test.yamljika proyeknya belum punya. Lihat tes simulasi di CI.
Proyek Mokxi-mu
- Klik ikon Mokxi di Activity Bar dan tekan Masuk. Setujui kode singkat di browser-mu, atau tempel token dari Settings > Developer.
- Proyekmu tercantum di sidebar. Klik salah satu untuk membukanya sebagai folder.
- Edit sketch-nya. File
.inomendapat penyorotan Arduino, dan snippet sepertisketch,blink,buttondanevery. - Tekan Sync (ikon awan di bar judul editor) untuk mengirimkannya ke Mokxi.
- Open in Mokxi (item Mokxi di status bar) membukanya di editor di browser-mu.
Sync tidak akan menimpa pekerjaan yang kamu lakukan di browser sejak sync terakhir, dan Pull tidak akan membuang editan yang belum kamu sync. Masing-masing menjelaskan alasannya dan membiarkanmu memilih. Membuka, sync, pull dan upload adalah bagian dari Pro.
Kompilasi dan upload
Mokxi: Compile (arduino-cli) memakai arduino-cli jika kamu memilikinya, dengan error di panel Problems, dan Mokxi: Compile and Upload to Mokxi melakukan sync, kompilasi, dan menyimpan build bersama proyek, jadi mokxi.com menjalankan persis apa yang kamu build. Kamu tidak perlu arduino-cli untuk panel simulator, yang mengompilasi sketch-nya sendiri.
Command line
Hal yang sama bisa dilakukan dari terminal dengan npx @mokxi/cli. Lihat
Command line 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
Paket mana saja
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 tes simulasi di 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.