Smara-CLI

README

Smara CLI 🌀

Autonomous Multi-Agent Terminal v1.8.0

Smara (Sanskerta: स्मृति — Ingatan) adalah terminal pintar berbasis Go yang mengorkestrasi agen AI otonom dengan memori tim yang tersinkronisasi dan integrasi MCP (Model Context Protocol).

---

✨ Fitur Utama

• Multi-Agent System: Arsitektur Supervisor-Worker untuk pendelegasian tugas yang kompleks.
• 3 Mode Agen:
  • ask (💬): Tanya-jawab cepat tanpa tools.
  • rush (⚡): Eksekusi cepat, langsung bertindak menggunakan tools.
  • plan (📋): Membuat rencana dan meminta persetujuan sebelum eksekusi.
• Platform Integration: Jalankan Smara sebagai bot di Telegram dan Discord.
• Multi-Provider LLM: Mendukung Ollama (local), Anthropic, OpenAI, dan OpenRouter.
• Persistent Sessions: Riwayat percakapan dan status agen kini tersimpan secara otomatis di SQLite, memungkinkan Anda melanjutkan sesi sebelumnya.
• Smart Memory: Menggunakan SQLite & Vector Search untuk menyimpan konteks percakapan lintas platform.
• MCP Integration: Secara otomatis mendeteksi dan menghubungkan ke server MCP dari OpenCode.
• Auto-Update: Sistem pembaruan otomatis bawaan menggunakan perintah smara update.

---

🚀 Instalasi Cepat

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/gede-cahya/Smara-CLI/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/gede-cahya/Smara-CLI/main/install.ps1 | iex

---

🔑 Setup & Konfigurasi

1. Login ke Provider

Gunakan perintah login untuk menyimpan API key secara aman:

smara login

2. Pilih Model

smara provider select

3. Konfigurasi Bot (Optional)

Tambahkan token di ~/.smara/config.yaml atau via environment variables:

export SMARA_TELEGRAM_TOKEN="your_bot_token"
export SMARA_DISCORD_TOKEN="your_bot_token"

---

🌐 Smara Serve (Platform Bot)

Smara dapat dijalankan sebagai layanan bot yang aktif terus-menerus.

# Jalankan semua platform yang dikonfigurasi
smara serve

# Jalankan platform spesifik dengan mode default 'plan'
smara serve --platform telegram --mode plan

🤖 Perintah Bot Messaging:

• /ask <prompt> — Kirim pertanyaan cepat.
• /mode <ask|rush|plan> — Ganti mode agen.
• /mcp — Lihat daftar tool yang tersedia.
• /clear — Reset sesi percakapan.

---

🛠️ Perintah CLI Utama

• smara start: Mulai sesi interaktif TUI.
• smara provider list: Lihat provider yang tersedia.
• smara config list: Cek konfigurasi saat ini.
• smara update: Perbarui ke versi terbaru.
• smara version: Tampilkan informasi versi.

---

⚙️ Konfigurasi Detail (config.yaml)

provider: anthropic
model: claude-3-5-sonnet-latest
ollama_host: http://localhost:11434
platforms:
  telegram:
    enabled: true
    token: "YOUR_TOKEN"
    allowed_users: ["12345678"]
    rate_limit: 20
  discord:
    enabled: true
    token: "YOUR_TOKEN"
    allowed_roles: ["smara-user"]

---

📄 Lisensi

MIT License - © 2026 Gede Cahya.