docs

Minicode — Dokumentasi

Minicode adalah coding agent CLI berbahasa Indonesia. Ia membantu Anda bekerja dengan kode — membaca, menulis, mencari, dan menjalankan perintah — dengan menerima perintah dalam bahasa Indonesia atau Inggris.

Minicode dibangun di atas kernel kecil bernama MiniCore. Kernel inilah yang mengurus pekerjaan inti: menerima permintaan, memilih langkah, menjalankan alat, dan melaporkan hasilnya.

Apa itu Minicode?

Singkatnya: Minicode adalah asisten yang bekerja di terminal. Anda memberinya tugas dalam bahasa Indonesia atau Inggris, dan ia melakukan pekerjaan tersebut langkah demi langkah, sambil menunjukkan apa yang sedang dilakukan.

Di balik layar, ada dua bagian utama:

• MiniCore — bagian inti yang dibekukan. Ia mengurus alur kerja dasar: menerima permintaan, memilih tindakan, menjalankan alat, dan melaporkan hasil. Bagian ini sengaja dibuat kecil dan stabil. Versi Minicode berikutnya tidak akan mengubah inti ini, kecuali untuk tambahan kecil yang tidak mengganggu fungsi aslinya.

• Minicode — bagian yang Anda gunakan. Ia bekerja di terminal, menerima perintah dalam bahasa Indonesia atau Inggris, dan menggunakan berbagai alat untuk menyelesaikan tugas Anda. Alat-alat yang tersedia antara lain: membaca dan menulis file, menjalankan perintah, mencari di kode, terhubung ke penyedia Kecerdasan Buatan (AI), serta beberapa alat bantu lain.

Struktur singkat

Berikut adalah gambaran singkat tentang apa yang ada di dalam Minicode. Ini bukan informasi wajib untuk penggunaan umum, tetapi bisa membantu Anda memahami biaya dan cara kerjanya.

• Komponen inti (vendor/minicore) — kernel yang dibekukan, tidak bergantung pada paket lain.
• Alat-alat — untuk membaca dan menulis file, menjalankan perintah, dan bekerja dengan kode.
• Penanganan tugas — dapat membagi pekerjaan ke agen lain yang bekerja secara terpisah.
• Kebijakan keamanan — membatasi apa yang boleh dijalankan, sehingga pekerjaan tetap terkendali.
• Penyedia Kecerdasan Buatan — terhubung ke layanan AI yang Anda pilih.
• Alat bantu eksternal — bisa terhubung ke layanan MCP dan LSP untuk fungsi tambahan.
• Memori & sesi — mencatat riwayat pekerjaan dan menyimpan ringkasan yang relevan.
• Kemampuan khusus — seperti membaca struktur kode, menyimpan dan melanjutkan sesi, serta pemeriksaan otomatis.

Privasi & kejujuran

Beberapa hal penting yang perlu Anda tahu:

• Tidak ada data yang dikirim tanpa sepengetahuan Anda. Konfigurasi Anda tersimpan di komputer Anda sendiri. Token akses disimpan dengan aman dan tidak disebarkan.
• Kegagalan dilaporkan apa adanya. Jika ada masalah, Minicode akan memberitahu secara langsung, tanpa disamarkan.
• Informasi kuantitatif tidak ditulis secara permanen di sini. Jika Anda ingin tahu jumlah test, cakupan, atau jumlah alat yang tersedia, jalankan perintah bun test, bun run gate:coverage, atau lihat hasil di layanan continuous integration (CI). Informasi seperti ini bisa berubah sewaktu-waktu.
• Riwayat perubahan tercatat di CHANGELOG.md di direktori utama repo.

Mulai dalam 5 menit

Yang Anda butuhkan: Bun versi 1.0 ke atas. Tidak perlu instalasi lain.

# Salin repo ke komputer Anda
git clone https://github.com/startupmini/minicode && cd minicode

# Pasang ketergantungan
bun install && bun link

Selanjutnya, coba perintah-perintah ini untuk melihat bagaimana Minicode bekerja:

minicode                # Mulai Minicode — akan muncul panduan jika ini pertama kalinya
minicode "buat http server" --verbose
minicode auth login     # OAuth device-code bila provider mendukung; lainnya via API key
minicode providers      # Lihat daftar penyedia yang tersedia
minicode doctor         # Cek kondisi jika ada yang tidak beres

Untuk langkah selanjutnya — mulai dari awal sampai membuat prompt pertama yang terverifikasi — baca Quickstart. Jika Anda ingin tahu tentang instalasi di sistem operasi berbeda, atau cara memperbarui dan menghapus Minicode, baca Instalasi.

Mulai di sini

Anda baru dan tak mau menebak urutan baca? Ikuti jalur ini (total ±15 menit):

0. Apa MiniCode? — Konsep & Desain (3 menit): apa, kenapa, dan apa yang sengaja tidak ada.
1. Install — Instalasi (5 menit): Bun, clone, doctor.
2. Prompt pertama — Quickstart (5 menit): wizard/API key atau OAuth, prompt ter-verify pertama.
3. Pilih mode — Memilih Mode (2 menit): baca, ubah, approve, atau plan.
4. Workflow pertama — CLI + REPL: flag harian dan slash command sesuai kebutuhan.

Habis itu, baca sesuai kebutuhan lewat tabel Navigasi di bawah — tak perlu berurutan.

Navigasi

Anda ingin...	Baca...
Mengerti apa itu Minicode dan alasan dibaliknya	Konsep & Desain
Cara menginstall, memperbarui, atau menghapusnya	Instalasi
Mulai dari nol sampai membuat prompt pertama yang terverifikasi	Quickstart
Arti istilah-istilah yang dipakai di sini	Glosarium
Semua perintah CLI dan flag yang tersedia	CLI
Perintah khusus di dalam Minicode dan tombol pintas	REPL
Cara menjalankan Minicode tanpa interaksi (otomatis / di CI)	Otomasi & CI
Cara menyimpan pengaturan dan di mana data tersimpan	Config
Cara menambah penyedia AI dan mengelola akses	Config & Provider
Cara memperkirakan biaya dan membatasi pengeluaran	Pricing & Budget
Semua variabel lingkungan yang tersedia	Environment Variables
Cara membuat perintah khusus (skill) dan skrip terbatas	Skills & Hooks
Sub-agent delegate_task, mode explore/plan, recovery	Sub-Agents & Tasks
MCP stdio/HTTP, LSP, mcp serve	MCP & LSP
Memory RAG, sessions, undo/redo, recovery journal	Memory & Sessions
Auto-verify, benchmark, SWE-bench Lite, harness audit	Verify & Benchmark
Permission mode, bash-guard, jail, sandbox	Policy & Sandbox
Threat model, prompt injection, supply chain	Keamanan
Error umum + doctor	Troubleshooting
Peta lapisan, alur satu prompt	Arsitektur
Kontrak stdout/stderr FROZEN, 12 invariant	Kontrak Terminal
Ikut kontribusi, gate, batas lapisan	Contributing
Perubahan per versi	Changelog
Arsip panduan monolit lama (baca hanya bila perlu)	USAGE.md (file pendamping, status legacy)

Konvensi dokumen ini

• Bahasa: Indonesia, istilah teknis tetap English (provider, checkpoint, sandbox).
• Komentar kode di repo juga Indonesia (menjelaskan mengapa, bukan apa) — kecuali klaim CONTRIBUTING.md yang masih English-only dan sedang direkonsiliasi di halaman Contributing.
• Setiap klaim perilaku merujuk ke file:line agar bisa diverifikasi dengan read_file + offset/limit.
• Encoding UTF-8 tanpa BOM. Jangan commit rahasia (API key, token OAuth).