netrapod-cli

CLI coding assistant bergaya Claude Code/Codex, installable via npm global. Default backend sudah diset ke BytePlus ModelArk (OpenAI-compatible). Mode default sekarang TUI full-screen (panel + input reaktif), bukan prompt baris biasa.

Install

npm install
npm link

Setelah npm link, command global netrapod tersedia di terminal.

Alternatif langsung install global dari folder ini:

npm i -g .

Command alias aicode tetap tersedia untuk kompatibilitas.

Environment (BytePlus ModelArk)

Minimal:

export ARK_API_KEY="your_modelark_api_key"

Opsional:

export ARK_BASE_URL="https://ark.ap-southeast.bytepluses.com/api/v3"
export AICODE_MODEL="kimi-k2-thinking-251104"
# alias yang juga didukung:
# export ARK_MODEL="kimi-k2-thinking-251104"
# export AICODE_BASE_URL="https://ark.ap-southeast.bytepluses.com/api/v3"
# export AICODE_CONTEXT_WINDOW="128000"
# export MODELARK_API_KEY="..."
# export MODELARK_BASE_URL="..."

Catatan:

• CLI ini pakai OpenAI SDK (openai) dengan mode OpenAI-compatible, sama seperti snippet docs ModelArk.
• Kamu bisa ganti AICODE_MODEL ke endpoint model lain yang aktif di akunmu.

Pakai

Mode interaktif:

netrapod

Mode klasik (line-based):

netrapod --plain

One-shot:

netrapod "buatkan rencana refactor untuk src/tools.js"

Setup interaktif ulang:

netrapod --setup

Saat pertama kali dijalankan tanpa API key, netrapod otomatis masuk wizard setup:

• input ARK_API_KEY
• konfirmasi Base URL dan Model
• opsi simpan config ke ~/.netrapod/config.json

Di mode TUI:

• Tab untuk pindah fokus input/log
• PgUp/PgDown untuk scroll log
• ? untuk shortcut modal
• ketik / untuk buka command picker, lalu pilih dengan ↑/↓ dan Enter
• panel response memakai area log full-width supaya output lebih lebar
• session chat tersimpan di ~/.netrapod/sessions dan session terakhir otomatis dilanjutkan
• stream realtime ditampilkan untuk model output + event tool (read_file, write_file, run_command, dll)
• thinking ditampilkan dengan animasi live saat model sedang memproses
• superpower workflow aktif by default (auto-detect), bisa dimatikan dengan --no-superpowers atau /super off
• saat AI memberi opsi bernomor, muncul option picker (↑/↓ lalu Enter) untuk kirim pilihan tanpa ngetik manual
• ada indikator context usage (estimasi token) sampai 100% di panel/header

Command dalam sesi

• /help lihat semua command
• /status lihat model/cwd/config aktif
• /model <name> ganti model
• /cwd <path> ganti workspace root
• /auto on|off toggle auto approval untuk run/write
• /tools on|off enable/disable tool-calling
• /super on|off|status|list|info kontrol mode superpower
• /brainstorm <tujuan> jalankan workflow brainstorming (design dulu, coding belakangan)
• /write-plan <tujuan> jalankan workflow pembuatan implementation plan detail
• /execute-plan <plan> jalankan workflow eksekusi plan per batch
• /debug-root <masalah> jalankan workflow systematic root-cause debugging
• /run <command> jalankan command shell
• /read <path> [start] [end] baca file
• /write <path> tulis file (akhiri input dengan .end)
• /append <path> append file (akhiri input dengan .end)
• /session ... kelola session chat (list, new, use, save, rename)
• /reset reset context chat
• /quit keluar

Catatan keamanan

Secara default, aksi berisiko (run_command dan write_file) meminta konfirmasi.
Pakai --auto-approve hanya jika kamu paham risikonya.

Referensi Superpowers

Fitur workflow ini diinspirasi dari project:

• https://github.com/obra/superpowers