← Dokumentasi

Instalasi

Prasyarat tunggal: bun >= 1.1.13 — runtime Minicode, bukan Node.js. npm hanya dipakai untuk distribusi, bukan untuk menjalankan. (Lantai versi: kode memakai AbortSignal.any() yang absen di Bun 1.0.x; minicode gagal cepat dengan pesan jelas bila versi lebih lama.)

Kernel MiniCore ikut repo di vendor/minicore, jadi tanpa clone tambahan. Clone sibling ../minicore hanya dibutuhkan bila kamu mau sync ulang kernel via bun run vendor:minicore.

Install (untuk awam — tanpa Node/Bun sekalipun)

Langkah 1 — Pasang Bun (sekali saja, tutup-buka terminal lagi setelahnya):

# Windows PowerShell
powershell -c "irm bun.sh/install.ps1 | iex"
# kalau gagal karena ExecutionPolicy, coba:
npm install -g bun
# macOS / Linux
curl -fsSL https://bun.sh/install | bash

Cek: bun --version harus keluar versi ≥ 1.1.13 (contoh 1.4.x). Kalau masih command not found, tutup-buka terminal dulu (PATH baru ke-load setelah restart).

Langkah 2 — Pasang Minicode:

npm install -g minicode-ai
# bin: minicode
minicode --version  # pastikan versi terbaru terpasang

Kenapa butuh keduanya? npm = toko distribusi, Bun = mesin yang menjalankan. Tanpa Bun, minicode gagal dengan 'bun' is not recognized.

Untuk kontributor (kerja dari source):

git clone https://github.com/minilabs-id/minicode && cd minicode
bun install && bun link

Opsional tapi disarankan: rg (ripgrep) di PATH mempercepat tool grep. Tanpa rg, walker internal dipakai dengan hasil identik (paksa jalur itu untuk uji dengan MINICODE_GREP_ENGINE=js).

Verifikasi:

minicode doctor        # runtime, provider, pricing, memory, sandbox, config
bun test               # offline/hermetic; live & docker di-skip otomatis

Setup wizard berjalan otomatis saat minicode pertama kali bila belum ada provider.

Matriks OS

OS · Sandbox otomatis · Default permission · Catatan

Linux + bubblewrap · Ya, tanpa flag · auto · Paling terisolasi untuk bash

macOS + seatbelt · Ya, tanpa flag · auto · Sama, via seatbelt

Windows (semua) / tanpa bwrap-seatbelt · Tidak tersedia · auto (bash restrictBash allow-list otomatis) · Lebih baik membatasi perintah daripada label aman palsu. Pilih sendiri dengan --allow-all / --ask, matikan dengan --sandbox none, atau pakai --sandbox docker

Docker tidak dipakai otomatis meski tersedia — menarik image tanpa diminta terlalu invasif untuk default.

Update & uninstall

Membuka minicode interaktif (TTY) selalu cek versi terbaru ke registry: versi SemVer tepat yang ditemukan diverifikasi dahulu lewat instalasi sementara dan npm audit signatures (signature registry + provenance). Skrip instalasi paket dimatikan; hanya graph tanpa dependency runtime yang diterima. Setelah itu versi yang sama dipasang dari registry resmi, versi di package terpasang dibaca ulang, lalu minicode restart sendiri. Ketidakcocokan mencoba memulihkan versi sebelumnya; bila pemulihan gagal, proses berhenti agar tidak berjalan dengan instalasi campuran. Berlaku hanya untuk salinan ter-install (checkout source tidak disentuh). Npm lama, paket tanpa bukti signature/provenance, offline, atau install gagal menahan auto-update dan memberi instruksi manual. One-shot, exec, pipe, dan CI hanya menampilkan notifikasi (tanpa install).

Verifikasi memakai kemampuan npm, bukan verifier Sigstore yang dibundel
MiniCode. Gagal-verifikasi selalu menghentikan update otomatis. Pemilik tetap
dapat mematikan jalur ini (MINICODE_AUTO_UPDATE=0) dan mengelola update
manual sesuai kebijakan organisasinya.
npm install -g minicode-ai@<versi> # manual, gunakan versi yang sudah ditinjau
minicode sync          # refresh model baru dari semua provider
minicode pricing sync  # refresh cache harga dari models.dev

Opt-out: NO_UPDATE_CHECK=1 atau MINICODE_AUTO_UPDATE=0.

Clone contributor: cd minicode && git pull && bun install.

Uninstall = npm uninstall -g minicode-ai (atau hapus clone + bun unlink bila memakai link). Config global tetap di ~/.minicode/ sampai kamu hapus manual; config lokal di .minicode/ per repo. Uninstall tidak pernah menghapus state, sesi, memori, atau file proyekmu.

Lokasi data

  • Config global ~/.minicode/config.json + lokal .minicode/config.json (merge, lokal menang, tulis atomik + chmod 600).
  • Token OAuth di ~/.minicode/auth.json (chmod 600) — bukan di config.json, karena config lokal sering ikut ter-commit.
  • Sessions .minicode/sessions.db (WAL), vector memory vector.db, repo-map .minicode/repomap.json, traces .minicode/traces.jsonl, checkpoint .minicode/checkpoints/, trash .minicode/.trash/.
  • Override home untuk DB dengan MINICODE_HOME (berguna agar test hermetic di POSIX).

Berikutnya