m>minicode

Troubleshooting

sumber: cli/commands/doctor.tsEdit di GitHub

Troubleshooting

Mulai selalu dari:

minicode doctor [--json]   # runtime, provider, pricing, memory, sandbox, config

doctor memberi warn (bukan ok palsu) untuk provider 0 models + saran sync.

FAQ (dari docs/USAGE.md)

  • LSP tidak jalan: minicode config lsp add .ts --command typescript-language-server --args --stdio. Pastikan server terinstall.
  • Docker sandbox: docker pull node:22-alpine. Daemon mati → turun ke allowlist, bukan tanpa isolasi.
  • Perintah aman ditolak? Kemungkinan default allowlist karena tanpa OS sandbox. Pesan [sandbox] di awal run menjelaskannya. Pilih --allow-all/--ask, atau bun experiments/bash-bypass-probe.ts untuk lihat yang dianggap sah.
  • --sandbox os tak berefek: bwrap/seatbelt tidak ada di Windows. Pakai --sandbox docker.
  • Env hilang di subprocess: hanya kata-kunci kredensial di-strip. GITHUB_WORKSPACE/REDIS_HOST/AWS_REGION tetap ada; GITHUB_TOKEN/AWS_SECRET_ACCESS_KEY/DATABASE_URL di-strip. Bila non-rahasia ikut hilang, itu bug — laporkan nama variabelnya.
  • grep lambat: install rg. Bandingkan dengan MINICODE_GREP_ENGINE=js.
  • /undo tak pulihkan file tertentu: file itu kemungkinan di .gitignore (shadow-git hanya snapshot yang dilacak git).
  • MCP HTTP "host privat": butuh --allow-private saat add. Ini penjaga SSRF.
  • MCP "redirect tidak diikuti": perbaiki URL; redirect sengaja tidak diikuti.
  • auth login gagal: error server ditampilkan apa adanya. Cek minicode auth list.
  • Provider OAuth hilang: belum login / refresh gagal. minicode auth status → auth login <id>.
  • git_commit ditolak: di-gate; non-TTY selalu tolak. Itu perilaku yang diinginkan.
  • Biaya N/A: minicode pricing sync → pricing show <model>.
  • File besar tak terbaca: pakai offset/limit (read_file >2 MB memang menolak tanpa itu).
  • Background job tak jalan: background:true ditolak saat --sandbox aktif.
  • Verify tak jalan: set MINICODE_VERIFY_CMD / verifyCommand.
  • Budget tak akurat: harga estimasi; biaya riil tergantung provider.
  • bun install gagal cari minicore: pastikan vendor/minicore ada (ikut repo). Sync ulang butuh sibling ../minicore + bun run vendor:minicore.
  • /sync bilang restart? Hanya bila benar ada model baru (sync jujur {updated,failed}).
  • models --match kosong? Header noise sudah dibersihkan; kosong = benar tidak match.
  • Warna bocor ke pipe? Warna di-gate stdout.isTTY; NO_COLOR menang; TERM/COLORTERM tidak menyalakan warna di pipe.

Bantuan lanjutan

  • CLI untuk flags --sandbox --budget --tool-scope.
  • Policy & Sandbox untuk batas analisis statis.
  • Memory & Sessions untuk resume/undo/journal.
  • Lapor bug: sertakan doctor --json, OS, bun --version, dan langkah reproduksi minimal.