◆ Namo Studio

Your AI builder for code, projects, and development tasks. AI CLI agent yang bekerja di terminal: streaming chat, autonomous agent dengan diff preview, memory system, dan security layer. AI gratis aktif secara default.

 _  _       _  _       __  __       _____
| \| |     /_\  \     |  \/  |     /  _  \
| .` |    / _ \  \    | |\/| |    |  | |  |
|_|\_|   /_/ \_\__\   |_|  |_|     \_____/

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

⚡ Install

npm install -g namo-studio

Lalu jalankan:

namo

Initial screen Namo Studio langsung muncul: ASCII logo besar, input box, dan daftar suggestions. Ketik apa yang mau dibangun, atau pilih suggestion dengan arrow keys.

🆓 AI gratis aktif default: FreeModel sudah terpasang otomatis — tidak perlu API key, tidak perlu daftar apa pun.

🖥️ Initial Screen

╭────────────────────────────────────────────────────────────────╮
│  ◆ Namo                                                       │
│                                                                │
│           _  _       _  _       __  __       _____              │
│          | \| |     /_\  \     |  \/  |     /  _  \             │
│          | .` |    / _ \  \    | |\/| |    |  | |  |            │
│          |_|\_|   /_/ \_\__\   |_|  |_|     \_____/             │
│                                                                │
│                         Namo Studio                             │
│                                                                │
│             Your AI builder for code, projects,                 │
│                    and development tasks.                       │
│                                                                │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │ › Ask Namo to build something...                         │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                │
│  Suggestions                                                    │
│                                                                │
│  › Build something from an idea                                │
│  › Create files and folders                                    │
│  › Modify existing code                                        │
│  › Fix bugs and errors                                         │
│  › Analyze my project                                          │
│  › Build Roblox systems                                        │
│  › Run commands in the terminal                                │
│                                                                │
│  ───────────────────────────────────────────────────────────── │
│  qwen2.5-coder · ~/project                                     │
╰────────────────────────────────────────────────────────────────╯

• Arrow up/down — pilih suggestion
• Tab — isi input dengan suggestion terpilih
• Enter — kirim (input, atau suggestion terpilih)
• Esc — kosongkan input · Ctrl+C — keluar
• Logo mengecil proporsional di terminal sempit, tanpa horizontal scroll

💬 Chat Session

Setelah submit dari initial screen (atau namo chat), kamu masuk sesi chat — ASCII logo tetap menjadi identitas di bagian atas, lalu pesan kamu dan jawaban AI tersusun di bawahnya:

 _  _       _  _       __  __       _____
| \| |     /_\  \     |  \/  |     /  _  \
| .` |    / _ \  \    | |\/| |    |  | |  |
|_|\_|   /_/ \_\__\   |_|  |_|     \_____/
                        Namo Studio
            Your AI builder for code, projects,
                 and development tasks.
  ────────────────────────────────────────────

  ❯ You
    hi

  ◆ Namo
    Halo! Ada yang bisa Namo bantu hari ini?

  ❯ You
    bahasa apa kamu?

  ◆ Namo
    Saya berbahasa Indonesia — tapi bisa juga...

• Jawaban AI streaming real-time, code block dirender sebagai panel
• Ketik pesan yang terlihat seperti task development (mis. "buat file X") → Namo menawarkan agent mode (plan → approve → file/command → report)
• /agent <task> — jalankan agent langsung dari chat
• /clear — hapus riwayat + tampilkan header lagi

📋 Commands

| Command | Fungsi | |---|---| | namo | Initial screen — mulai membangun (recommended) | | namo chat | Chat streaming di terminal | | namo agent "task" | Agent mode — AI bekerja otomatis (--yes untuk full-auto) | | namo init | Scan project + buat .memory/ | | namo scan | Scan project (framework, language, database) | | namo review | Code review: security, performance, quality | | namo models | Lihat / ganti model AI | | namo config | Baca / ubah konfigurasi | | namo --setup | Setup wizard model AI |

Shortcut Commands

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

🤖 Multi Model Support

| Gratis | Local (privasi penuh) | Cloud (performa maksimal) | |---|---|---| | FreeModel 🆓 | Ollama | OpenAI | | | Llama | Groq | | | Qwen | DeepSeek | | | DeepSeek | Mistral | | | Mistral | OpenRouter |

FreeModel sudah include API key gratis — aktif otomatis saat pertama menjalankan namo. Model: llama3.1:8b, deepseek-coder:6.7b, qwen2.5:7b, qwen2.5-coder:7b.

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

🧠 Agent Mode

Task → Analyze → Create Plan → Ask Approval → Execute → Verify → Report

• Diff preview — sebelum file diubah, Namo menampilkan diff +/- ala git
• Approval modes — manual (semua konfirmasi), auto-edit (file otomatis, command konfirmasi), full-auto/--yes (semua otomatis, command berbahaya tetap ditolak)
• Streaming chat — jawaban muncul token demi token, code block dirender sebagai panel berlabel bahasa
• Memory system — .memory/ menyimpan konteks project & riwayat task

🛡️ Security Layer

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

🧠 Memory System

namo init membuat folder .memory/ di project:

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

💡 Contoh Sesi

$ namo

# initial screen muncul — ketik:
› buatkan REST API todo list dengan Express

# Namo: Analyze → Plan → Approve? y → buat file → Report Complete ✓

$ namo agent "perbaiki bug di login page" --yes   # full-auto
$ namo chat                                        # ngobrol santai
$ namo review                                      # audit kualitas project

⚙️ Konfigurasi

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

namo config                              # lihat semua (secret disembunyikan)
namo config get model.model              # lihat satu key
namo config set model.model qwen2.5:7b   # ubah satu key

🧑‍💻 Development

git clone https://github.com/namo-studio/namo
cd namo
node bin/namo.js

Struktur:

bin/namo.js              # entry point & router command
lib/initial-screen.js    # initial screen TUI (ASCII logo, input, suggestions)
lib/ui.js                # terminal UI engine (warna, panel, diff, prompt)
lib/ai.js                # client multi-model + streaming SSE
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, review, models, shortcuts

📄 License

MIT © 2026 Namo Studio

◆ Namo Studio — Your AI builder for code, projects, and development tasks.