🦀 SeaCrabs AI CLI

AI tidak hanya menjawab — AI yang bekerja. Autonomous coding agent di terminal: auto planning, multi-step execution, self correction, dan goal tracking. Dilengkapi memory system, security layer, multi-model support, dan SeaCrabs Message (email resmi @seacrabs.id).

Zero dependencies — cepat di-install, tanpa supply-chain risk. Cukup Node.js ≥ 18.

⚡ Install

npm install -g seacrabs

Lalu mulai:

seacrabs --setup

Setup wizard akan memandu kamu: Models AI → Account SeaCrabs (@seacrabs.id) → SeaCrabs Message.

🆓 Baru di v1.1.0 — FreeModel (GoModel): AI gratis seperti OpenAI, tanpa API key sendiri! Pilih "FreeModel — GoModel" saat setup dan langsung pakai model llama3.1:8b, deepseek-coder:6.7b, qwen2.5:7b, atau qwen2.5-coder:7b.

🖥️ Chat & Agent ala Codex: streaming respons real-time, code panel dengan border, diff preview sebelum file diubah, dan approval modes (manual / auto-edit / full-auto).

🧠 Apa itu SeaCrabs?

SeaCrabs adalah AI CLI agent yang bekerja seperti anggota tim:

User Request → Analyze → Create Plan → Ask Approval → Execute Task → Verify Result → Report

AI tidak hanya menjawab pertanyaan — AI menganalisis project, menyusun rencana, meminta persetujuanmu, menulis kode, menjalankan command, mengetes hasil, dan melaporkan semuanya.

📋 Commands

| Command | Fungsi | |---|---| | seacrabs --setup | Setup wizard (Models AI, Account @seacrabs.id, Message) | | seacrabs chat | Chat mode streaming ala Codex di terminal | | seacrabs agent "task" | Agent mode — AI bekerja otomatis (--yes untuk full-auto) | | seacrabs init | Scan project + buat .memory/ | | seacrabs scan | Scan project (framework, language, database, package manager) | | seacrabs message | Buka inbox SeaCrabs Message (@seacrabs.id) | | seacrabs review | Code review: security, performance, quality score | | seacrabs models | Lihat / ganti model AI | | seacrabs config | Baca / ubah konfigurasi |

Shortcut Commands

seacrabs /new       # buat project baru
seacrabs /open      # scan + buka project
seacrabs /build     # build project
seacrabs /test      # jalankan test
seacrabs /fix       # perbaiki error
seacrabs /explain   # jelaskan kode
seacrabs /refactor  # improvement kode
seacrabs /deploy    # deploy aplikasi

🤖 Multi Model Support

| Gratis | Local (privasi penuh) | Cloud (performa maksimal) | |---|---|---| | FreeModel — GoModel 🆓 | Ollama | OpenAI | | | Llama | Groq | | | Qwen | DeepSeek | | | DeepSeek | Mistral | | | Mistral | OpenRouter (Claude, Gemini, dll) |

FreeModel (GoModel) sudah include API key gratis — tidak perlu daftar apa pun. Model tersedia: llama3.1:8b, deepseek-coder:6.7b, qwen2.5:7b, qwen2.5-coder:7b.

Ganti model kapan saja dengan seacrabs models. Semua provider memakai API OpenAI-compatible — custom endpoint juga didukung.

Contoh pakai FreeModel (gratis, tanpa setup apa pun):

seacrabs --setup   # pilih nomor 1: FreeModel — GoModel [GRATIS]
seacrabs chat      # streaming real-time ala Codex
seacrabs agent "buatkan REST API todo list dengan Express" --yes

Contoh pakai Ollama (lokal & gratis):

# terminal 1
ollama serve

# terminal 2
seacrabs --setup   # pilih Ollama, model: qwen2.5-coder
seacrabs agent "buatkan REST API todo list dengan Express"

🧠 Memory System

seacrabs init membuat folder .memory/ di project:

.memory/
├── user.json         # info user
├── project.json      # hasil scan project
├── preferences.json  # preferensi
└── history.json      # riwayat task agent

🛡️ Security Layer

• Command approval — command berbahaya (rm -rf, sudo, dll) wajib konfirmasi
• Path guard — agent tidak bisa menulis file di luar folder kerja
• Secret protection — API key & password tidak pernah dicetak ke terminal
• Timeout guard — semua command punya batas waktu eksekusi

📬 SeaCrabs Message

Akun SeaCrabs memakai domain resmi @seacrabs.id (bukan Google / email biasa). Setiap pesan punya link unik dengan nomor acak:

/seacrabs/message/8472615

Baca inbox dari terminal:

seacrabs message

Hubungkan ke server SeaCrabs sendiri:

seacrabs config set messageApi https://server-seacrabs-kamu.id

🖥️ Ala Codex

Chat & Agent mode mengadopsi pengalaman OpenAI Codex CLI:

• Streaming real-time — jawaban muncul token demi token (/stream untuk toggle)
• Code panel — code block dirender dengan border + label bahasa
• Diff preview — sebelum file diubah, SeaCrabs menampilkan diff +/- ala git
• Approval modes — manual (semua konfirmasi), auto-edit (file otomatis, command konfirmasi), full-auto/--yes (semua otomatis, command berbahaya tetap ditolak)
• Header bar status — model aktif & mode selalu terlihat

💡 Contoh Sesi Agent

$ seacrabs agent "buatkan komponen Navbar React dengan Tailwind"

  🦀 Agent Mode — seperti Claude Code

  ✓ Plan siap — 3 langkah

  PLAN:
   1. Buat file src/components/Navbar.tsx
   2. Pastikan Tailwind class responsive
   3. Beri catatan penggunaan

  ACTIONS:
   [file] src/components/Navbar.tsx
   [info] Cara pakai komponen

  Approve plan? [Y/n]: y

  ✓ File created: src/components/Navbar.tsx
  🦀 Import Navbar lalu pakai <Navbar /> di layout kamu.

  ╭──────────────────────────────╮
  │ Report — Complete ✓          │
  ├──────────────────────────────┤
  │ Files created : 1            │
  │ Commands run  : 0            │
  │ Failed        : 0            │
  ╰──────────────────────────────╯

⚙️ Konfigurasi

Config global tersimpan di ~/.seacrabs/config.json.

seacrabs config                              # lihat semua (secret disembunyikan)
seacrabs config get model.model              # lihat satu key
seacrabs config set messageApi https://...   # ubah satu key

🧑‍💻 Development

git clone https://github.com/seacrabs/seacrabs-cli
cd seacrabs-cli
node bin/seacrabs.js --help

Struktur:

bin/seacrabs.js     # entry point & router command
lib/ui.js           # terminal UI (warna, spinner, prompt) — zero deps
lib/ai.js           # client multi-model (OpenAI-compatible)
lib/agent.js        # engine autonomous agent
lib/scanner.js      # project scanner
lib/security.js     # deteksi command berbahaya + path guard
lib/config.js       # config global + .memory/ project
lib/commands/       # setup, chat, agent, init, message, review, models, shortcuts

📄 License

MIT © 2026 SeaCrabs Team

🦀 SeaCrabs — AI Tidak Hanya Menjawab, AI yang Bekerja

seacrabs.id