minicode

Menggunakan

Environment Variables

Variabel yang paling menentukan perilaku (sisanya referensi di bawah):

  • Batas otonomi di mesin sendiri: MINICODE_SANDBOX + MINICODE_SANDBOX_STRICT=1 (tolak bash bila isolasi tak ada) + MINICODE_BUDGET_STRICT=1 (cost tak dikenal = over budget).
  • Privasi/minim jejak: MINICODE_TELEMETRY=0 (tanpa traces), MINICODE_AUTO_MEMORY=0 (tanpa auto-simpan memori).
  • Repo asing: JANGAN set MINICODE_ALLOW_LOCAL_CONFIG=1 kecuali workspace milik Anda.
  • Konsol lawas/aksesibilitas: MINICODE_ASCII=1, MINICODE_A11Y=1, MINICODE_BELL=0, NO_COLOR.

#Runtime & limits

VariabelFungsi
MINICODE_TIMEOUT_MSDefault timeout (ms) bila --timeout tidak diset; 0 = Infinity
MINICODE_PLAN1 → mode plan (tanpa --plan)
MINICODE_PERMISSIONallowlist → mode permission
MINICODE_TOOL_SCOPEexplore → subset read-only 12 tool (sama --tool-scope explore)
MINICODE_WORK_MODEDISCUSS | PLAN | EXECUTE → work mode (lapis intent di atas permission mode; sama --work-mode; flag menang atas env; nilai tak dikenal = EXECUTE)
MINICODE_HOOKS1 → jalankan hook pre/post-run dari ~/.minicode/hooks/*.js & .minicode/hooks/*.js (konteks di env MINICODE_HOOK_CTX; env hook disanitasi tanpa secret; dilewati bila sesi dibatalkan)
MINICODE_SESSION_TTL_DAYSTTL sesi (default 30; 0 = selamanya)
MINICODE_HOMEOverride home untuk DB lokal/global (sessions + vector); default ~
MINICODE_TELEMETRY0/false/off → matikan penulisan traces.jsonl
MINICODE_VERIFY_CMDCustom verify command (ganti detectVerifyCommand)
MINICODE_BASH_ALLOWLISTKustom allowlist bash (koma-pisah, ganti DEFAULT)

#Bahasa, diagnosis & kunci

VariabelFungsi
MINICODE_LANGen/id → bahasa UI (prioritas lengkap di kontrak terminal §i18n: /lang > env ini > state.json > locale OS > en)
MINICODE_DEBUG_STARTUP1 → cetak durasi tiap tahap setup sesi ke stderr (diagnosis startup lambat; diagnostik saja, bukan perilaku)
MINICODE_MINIMIZE_ANSWERset (nilai apa pun) → JANGAN auto-minimize section jawaban model (nilai unset = minimize default)
MINICODE_KEYSTORE_DISABLE1 → matikan keystore OS seluruhnya (jatuh ke penyimpanan file; untuk CI/headless yang tak punya keychain/DPAPI)
MINICODE_KEYSTORE_FORCE_DPAPIset (nilai apa pun) → paksa jalur DPAPI/Windows walau di non-Windows (khusus test portabilitas; bukan konfigurasi produksi)
MINICODE_MINIMIZE_TOOLset (nilai apa pun) → JANGAN auto-minimize section tool di TUI (nilai unset = minimize default)

#Sandbox

VariabelFungsi
MINICODE_SANDBOXdocker | os (alias bwrap/seatbelt) | none
MINICODE_SANDBOX_STRICT1 → tak pernah fallback host (redundan dengan default fail-closed untuk request eksplisit, tetap dihormati)
MINICODE_SANDBOX_ALLOW_FALLBACK1 → satu-satunya jalan fallback host yang sadar bila backend tak tersedia
MINICODE_SANDBOX_IMAGEImage Docker (default node:22-alpine — hanya bawa node; python butuh image sendiri)
MINICODE_SANDBOX_MEMORYMemory cap (default 512m)
MINICODE_GREP_ENGINEjs → paksa walker internal, jangan pakai ripgrep

#Provider & memory

VariabelFungsi
MINICODE_PROVIDER_ORDERUrutkan provider agnostik tanpa edit config: openai,anthropic,deepseek
MINICODE_EMBED_MODELModel embedding untuk memory/vector (default text-embedding-3-small)
MINICODE_COMPACT_KEEP_TURNSOverride keepRecentTurns kompaksi (bilangan ≥1; invalid → default kernel + warn)
MINICODE_MEMORY_SCOPEScope baca memory: cwd (default) | global | all (gabung, tanpa silent shadowing)
MINICODE_AUTO_MEMORY0 → matikan auto-simpan summary/snippet ke memory (opt-out)
MINICODE_REPOMAPregex → paksa repo-map regex (skip LSP)
TAVILY_API_KEYAPI key untuk Tavily web_search (fallback DuckDuckGo bila kosong)

#Budget & config

VariabelFungsi
MINICODE_BUDGET_STRICT1 → penegasan eksplisit fail-closed (cost tak dikenal + pemakaian = over; kini juga default --budget)
MINICODE_ALLOW_LOCAL_CONFIG1 → percayai config lokal workspace (default: diabaikan)

#Terminal & aksesibilitas

VariabelFungsi
MINICODE_ASCII1 → paksa glyph ASCII ([OK], >, .) untuk konsol tanpa UTF-8
MINICODE_COMPACT1 → tool call ringkas, 0 → expanded. Default: compact di REPL, expanded di one-shot/exec (juga /compact, Ctrl+O)
MINICODE_JUSTIFY0 → matikan rata kanan-kiri pada keluaran teks model
MINICODE_DROPDOWN0 → matikan floating dropdown, pakai hint inline (konsol legacy)
MINICODE_MOUSE_SELECTION0/false/off/no → matikan mouse tracking TUI; default 1 untuk drag selection + wheel
MINICODE_MOTION0 → matikan animasi status (pulse spark saat turn berjalan jadi glyph statis) — aksesibilitas/rekaman layar/SSH lambat
MINICODE_BELL0 → matikan bell \x07 saat approval (aksesibilitas)
MINICODE_STATUSLINErich → statusline turn menampilkan token kumulatif + biaya sesi (default hemat)
MINICODE_A11Y1 → live-region approval untuk screen reader (baris polos tanpa ANSI)
MINICODE_SHOW_THINKING1 → tampilkan reasoning model (--verbose atau env)
MINICODE_THINKINGoff → kirim enable_thinking:false ke OpenAI-compat (DeepSeek)
NO_COLORSet apa pun selain 0 → matikan seluruh warna

#API key fallback

VariabelFungsi
AGENT_API_KEY, AGENT_BASE_URL, AGENT_MODELFallback generik OpenAI-compat (dipakai provider-layer, memory, task)
OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEYFallback API key
DEEPSEEK_BASE_URLBase URL DeepSeek (default https://api.deepseek.com/v1, untuk compaction)
ANTHROPIC_MODELModel Anthropic bila tidak diset eksplisit

#Lanjut

  • CLI — padanannya dalam bentuk flag --.
  • Config — config file + lokasi data.
  • Keamanan — env scrub subprocess.