Metadata-Version: 2.4
Name: yncli
Version: 1.1.7
Summary: Autonomous Polyglot AI Coding Agent & TUI
Author: Yanzyuyu
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: rich>=13.7.0
Requires-Dist: prompt_toolkit>=3.0.40
Requires-Dist: requests>=2.31.0
Requires-Dist: pygments>=2.17.0
Requires-Dist: beautifulsoup4>=4.12.0
Dynamic: author
Dynamic: requires-python

# yncli

> AI coding agent untuk terminal. Langsung paham struktur workspace Anda, merancang rencana di `plan.md`, dan mengeksekusi kode tanpa basa-basi.

---

## ⚡ Cara Pasang & Jalankan

### Lewat NPX / NPM (Node.js)
```bash
# Langsung jalankan tanpa instalasi:
npx @yanzyuyu/yncli

# Atau pasang secara global:
npm install -g @yanzyuyu/yncli
yncli
```

### Lewat Pip / Pipx (Python)
```bash
# Pasang via pip:
pip install yncli
yncli

# Atau jalankan via pipx:
pipx run yncli
```

### Script Pasang Otomatis (PowerShell / Shell)
- **Windows (PowerShell)**:
  ```powershell
  irm https://raw.githubusercontent.com/yanzyuyu/yncli/main/install.ps1 | iex
  ```
- **macOS / Linux**:
  ```bash
  curl -fsSL https://raw.githubusercontent.com/yanzyuyu/yncli/main/install.sh | bash
  ```

---

## 💡 Kenapa Pakai yncli?

1. **Langsung Paham Isi Folder**  
   Begitu dibuka di direktori proyek, `yncli` otomatis membaca file kode ke memori aktif. Anda tidak perlu repot copy-paste isi file manual.

2. **Perencanaan Jelas (`plan.md`)**  
   Di **Plan Mode**, AI menganalisis sistem, menggambar rancangan ASCII, dan menulis dokumen PRD ke `plan.md` sebelum menyentuh kode produksi.

3. **Eksekusi Mandiri di Build Mode**  
   Di **Build Mode**, AI langsung memodifikasi file, membuat komponen baru, dan memvalidasi sintaks (JS/TS, Python, Rust, Go, PHP, dll.) secara mandiri.

4. **Tampilan Bersih Satu Baris**  
   Status eksekusi diperbarui di baris yang sama tanpa membanjiri layar terminal Anda dengan ratusan baris log yang tidak perlu.

---

## 🛠️ Contoh Penggunaan

### 1. Buka Konsol Interaktif
Cukup buka terminal di folder proyek Anda:
```bash
yncli
```

### 2. Kirim Instruksi Cepat Sekali Ketik
```bash
yncli "buatkan REST API FastAPI dengan autentikasi JWT dan SQLite"
```

### 3. Opsi Tambahan
```bash
# Ganti model AI:
yncli -m ag/claude-sonnet-4-6

# Mulai langsung di Plan Mode:
yncli --mode plan

# Aktifkan spesialisasi tertentu:
yncli -s architect
```

---

## ⌨️ Perintah di Dalam Konsol (Slash Commands)

| Perintah | Deskripsi |
| :--- | :--- |
| `/model` | Buka menu pop-up interaktif untuk memilih model AI (bisa diklik) |
| `/plan` | Masuk ke Plan Mode (Riset arsitektur & susun `plan.md`) |
| `/build` | Masuk ke Build Mode (Eksekusi pembuatan & modifikasi kode) |
| `/ask` | Masuk ke Ask Mode (Konsultasi murni tanpa edit file) |
| `/cd <folder>` | Pindah folder kerja aktif & muat ulang memori file |
| `/approval` | Atur apakah tool dijalankan otomatis atau konfirmasi manual |
| `/thinking` | Tampilkan atau sembunyikan proses penalaran AI |
| `/skill <nama>` | Ganti persona (ultrabrain, architect, debugger, dll) |
| `/clear` | Bersihkan riwayat chat dan segarkan memori proyek |
| `/save` | Simpan riwayat percakapan ke file Markdown |
| `/exit` | Keluar dari yncli |

---

## 📄 Lisensi
[MIT License](LICENSE) © 2026 Yanzyuyu.
