Quickstart 5 menit

sumber: cli/router.tsEdit di GitHub

Quickstart 5 menit

Tujuan: dari nol sampai prompt pertama yang ter-verify, tanpa membaca seluruh manual.

1. Jalan pertama (1 menit)

minicode

Bila belum ada provider, wizard setup muncul. Isi berurutan: pilih gateway → tempel API key (ter-masking) → auto-detect models. Wizard memakai picker (panah + filter), bukan readline nomor — mengetik di luar rentang tidak lagi diam-diam memilih [0].

Alternatif tanpa API key:

minicode auth login          # device-code: kode singkat + URL, setujui di browser
minicode auth status         # lihat kredensial + kapan kedaluwarsa

2. Prompt pertama (2 menit)

minicode "buat http server hello world di server.ts" --verbose

Yang terjadi: model menerima system prompt berisi # Environment (cwd + platform) + repo-map ringkas, lalu loop ReAct Thought → Action → Observation sampai jawaban final atau batas (--max-steps default 50, --timeout default 15 menit).

Coba mode interaktif:

minicode --interactive
# minicode › jelaskan isi src/tools/index.ts
# /model   → picker provider::model, Enter = pilih + atur effort
# /status  → token + biaya kumulatif sesi
# /exit    → keluar (Ctrl+C ganda juga bisa)

3. Verify otomatis (2 menit)

minicode --verify "fix bugs lalu typecheck"

Sebelum agen jalan, baseline diuji dulu. Bila baseline sudah merah, catatan Health-Check ditempel ke prompt awal agar agen memperbaiki dulu. Setelah run, verify dijalankan; bila gagal, agen self-heal maks 3 siklus. Output error dibungkus fence agar tidak jadi prompt injection. Custom command via MINICODE_VERIFY_CMD atau verifyCommand di config.

Contoh pola harian

minicode --ask "deploy script"          # human-in-loop confirmation card
minicode --sandbox docker "task"        # bash di container ephemeral
minicode --budget 0.50 "task besar"     # warn 80%, tolak prompt baru bila lewat
minicode exec "prompt" --json           # headless CI: JSONL stream + summary
minicode "/review src/a.ts"             # skill slash-command

Berikutnya

CLI untuk semua mode + flags.
REPL untuk slash command dan keyboard.
Config & Provider untuk pindah gateway dan model.