Editor

VS Code dan GitHub dengan Mokxi

Simpan proyekmu di repositori GitHub-mu sendiri, edit kodenya di VS Code, dan jalankan di Mokxi.

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

  1. Buka Export di header editor.
  2. 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.
  3. Kembali di editor, buka Export lagi dan tekan Save to GitHub.
  4. 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.yaml milik 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.yaml jika proyeknya belum punya. Lihat tes simulasi di CI.

Proyek Mokxi-mu

  1. Klik ikon Mokxi di Activity Bar dan tekan Masuk. Setujui kode singkat di browser-mu, atau tempel token dari Settings > Developer.
  2. Proyekmu tercantum di sidebar. Klik salah satu untuk membukanya sebagai folder.
  3. Edit sketch-nya. File .ino mendapat penyorotan Arduino, dan snippet seperti sketch, blink, button dan every.
  4. Tekan Sync (ikon awan di bar judul editor) untuk mengirimkannya ke Mokxi.
  5. 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.