Vei AI Agents (vei) 🤖⚡

Version: 1.0.0 (Master Edition) LLM Provider: NVIDIA AI Foundation (z-ai/glm-5.2 via openai SDK) License: ISC

Vei AI Agents adalah AI Coding Agent berbasis CLI yang dapat merencanakan (Plan), mengeksekusi (Act), menguji (Test), dan memperbaiki kode secara mandiri (Self-Healing) langsung di terminal Anda dengan integrasi NVIDIA AI Endpoint (z-ai/glm-5.2 model) dan human-in-the-loop control penuh.

✨ Fitur Utama

• Autonomous Coding Engine: Menerima instruksi bahasa natural untuk menulis boilerplate, fitur, maupun bug fixes.
• Rencana Kerja Terstruktur (/plan): Membuat checklist langkah-langkah kerja sebelum menulis kode apa pun, lengkap dengan persetujuan pengguna.
• Self-Healing Loop: Mendeteksi kegagalan tes/kompilasi, membaca log error, mendiagnosis masalah, dan memodifikasi file otomatis hingga 3 iterasi.
• Permission & Security Prompts: Melindungi workspace Anda dari perintah berbahaya (denylist/allowlist) dengan opsi Izinkan Sekali, Izinkan Selalu, dan Tolak.
• Instan Rollback (/undo): Mengambil backup snapshot file sebelum dimodifikasi sehingga Anda bisa membatalkan tindakan terakhir dengan mudah.
• Compact Token (/compact): Mengompresi riwayat percakapan panjang untuk menghemat kuota token API.

🚀 Instalasi Global

Pasang package secara global lewat npm:

npm install -g vei-ai-agents

🔑 Konfigurasi API Key

Vei AI Agents memerlukan NVIDIA API Key untuk bekerja. Silakan atur environment variable sebelum menjalankan vei:

Windows (PowerShell)

$env:NVIDIA_API_KEY="nvapi-YourNvidiaApiKeyHere"

Windows (CMD)

set NVIDIA_API_KEY=nvapi-YourNvidiaApiKeyHere

Linux / macOS

export NVIDIA_API_KEY="nvapi-YourNvidiaApiKeyHere"

Atau, Anda dapat membuat file .env di direktori proyek aktif:

NVIDIA_API_KEY=nvapi-YourNvidiaApiKeyHere

⌨️ Panduan Penggunaan

Jalankan perintah vei di terminal Anda:

vei

Anda akan masuk ke dalam Shell Interaktif Vei AI Agents. Cukup ketik instruksi Anda atau gunakan salah satu slash commands di bawah ini.

🛠️ Daftar Slash Commands

| Perintah | Deskripsi | |---|---| | /plan <goal> | Membuat dan menganalisis rencana kerja terstruktur sebelum eksekusi | | /code <goal> | Memulai eksekusi kode otonom dan self-healing loop langsung | | /diff | Menampilkan perbedaan kode yang dibuat dibanding state commit terakhir | | /test [cmd] | Menjalankan unit test proyek (default: npm test) | | /commit [msg] | Men-stage semua file di workspace dan melakukan Git commit | | /undo | Membatalkan perubahan file terakhir ke backup snapshot | | /permissions | Melihat allowlist & denylist izin perintah shell terminal | | /permissions allow <cmd> | Menambahkan perintah ke allowlist (bebas prompt) | | /permissions deny <cmd> | Menambahkan perintah ke denylist (perlu konfirmasi) | | /compact | Mengompresi riwayat chat panjang untuk menghemat token API | | /help | Menampilkan menu bantuan |

🛡️ Keamanan & Mitigasi Risiko

Karena eksekusi command berjalan langsung di host mesin Anda tanpa Docker sandbox:

1. Denylist Default: Perintah merusak seperti rm, del, rd, dan format dibatasi secara otomatis dan memerlukan persetujuan eksplisit.
2. Session Allowlist: Anda dapat menyetujui perintah tertentu untuk sesi aktif tanpa harus dikonfirmasi berulang kali.
3. Penyimpanan Snapshot: Semua perubahan file di-backup secara otomatis ke folder .vei_snapshots/ lokal untuk mitigasi jika terjadi kesalahan penulisan kode.