@vareon/arcana-cli-agent: Unified AI Operations via CLI Arcana CLI Agent adalah antarmuka baris perintah (CLI) yang canggih yang dirancang untuk menjembatani lingkungan terminal lokal dengan Arcana Backend API (layanan AI Vareon). Agen ini memungkinkan pengembang untuk mengotomatisasi, mengeksekusi, dan memantau tugas-tugas berbasis kecerdasan buatan, seperti pembuatan kode, pengoperasian agen otonom, dan operasi file terintegrasi, langsung dari shell mereka. Arsitektur & Desain Arcana CLI menggunakan desain hibrida untuk menawarkan fleksibilitas dan pengalaman pengguna yang kaya: | Mode | Teknologi Utama | Fokus | |---|---|---| | Non-Interaktif (Perintah Tunggal) | yargs | Eksekusi cepat, scripting, dan integrasi CI/CD. | | Interaktif (Shell) | Ink (React for CLIs) | Pengalaman pengguna terminal penuh, state management, polling tugas real-time, dan navigasi seperti shell. | Fitur Arsitektural Utama:

• Pengelolaan Konfigurasi Persisten: Menggunakan file lokal (.arcanacli.json) dan variabel lingkungan untuk memastikan konfigurasi (seperti API Key dan Base URL) dimuat dengan prioritas yang jelas.
• Version Check Integrasi: CLI secara otomatis mengambil versi runtime dari Arcana Backend API, memastikan transparansi dan kompatibilitas.
• Modular Command Structure: Semua operasi utama (code generate, agent run, file-operation, dll.) diatur secara modular menggunakan sub-perintah yargs. Instalasi Arcana CLI memerlukan Node.js (versi 20 atau lebih baru). npm install -g @vareon/arcana-cli-agent

⚙️ Konfigurasi Akses Konfigurasi dimuat dari variabel lingkungan (prioritas tertinggi) atau file .arcanacli.json di direktori home Anda. Perintah config Gunakan sub-perintah config untuk mengatur dan mengelola kredensial API secara persisten: | Perintah | Deskripsi | Contoh | |---|---|---| | arcana config set api_key | Menyimpan kunci API secara lokal. | arcana config set api_key sk_arcana_xyz123 | | arcana config list | Menampilkan konfigurasi yang tersimpan (nilai sensitif disamarkan). | arcana config list | Penggunaan Utama

1. Mode Interaktif (Arcana Shell) Masuk ke pengalaman terminal penuh untuk operasi yang membutuhkan konteks atau pemantauan berkelanjutan. arcana

Fitur Shell:

• Pemantauan Tugas Aktif: Memanfaatkan state management Ink untuk menampilkan dan memperbarui status tugas agen AI yang sedang berjalan secara real-time.
• Toggle Logging: Menggunakan Ctrl+O untuk mengaktifkan/menonaktifkan log debug internal.
• Perintah Internal: cd , exit, /model.

2. Mode Non-Interaktif (Skrip & CI/CD) Ideal untuk eksekusi perintah sekali jalan atau scripting otomatis. | Perintah | Deskripsi | Contoh | |---|---|---| | arcana code generate | Minta Backend AI untuk membuat kode. | arcana code generate "Buatkan script JS untuk mem-parsing argumen CLI" | | arcana shell translate | Terjemahkan instruksi ke perintah shell yang akurat. | arcana shell translate "list semua file yang lebih dari 10MB di folder saat ini" | | arcana agent run | Eksekusi tugas terperinci pada Agen Otonom tertentu. | arcana agent run dev-agent "optimalkan kinerja fungsi database" | | arcana file-operation [content] | Lakukan operasi file terintegrasi dengan konteks AI. Operasi: read, write, delete. | arcana file-operation read package.json | 🛠️ Pengembangan Proyek ini menggunakan Node.js dengan tipe commonjs. Dependensi Utama

• yargs: Untuk parsing argumen CLI non-interaktif.
• ink & react: Untuk pembangunan UI terminal interaktif.
• axios: Klien HTTP untuk komunikasi API.
• dotenv: Untuk memuat konfigurasi lingkungan. Build dan Tes Proses CI/CD untuk pengiriman ke NPM dikelola melalui GitHub Actions. npm install npm run test # Saat ini merupakan placeholder untuk pengujian unit

📄 Lisensi Proyek ini dilisensikan di bawah lisensi ISC.