Panduan Kiosapi CLI

# langsung (tanpa install)
npx kiosapi

# atau install global
npm i -g kiosapi
kiosapi

kiosapi masuk        # tempel kios_live_… (ditampilkan sebagai ****)
kiosapi periksa      # cek konektivitas, versi, & saldo
kiosapi --version    # tampilkan versi (alias: kiosapi versi / -v)
kiosapi perbarui     # update ke versi terbaru

# Linux/macOS : ~/.kiosapi/config.json
# Windows     : %USERPROFILE%\.kiosapi\config.json
{
  "apiKey": "kios_live_xxxxxxxxxxxx",
  "baseUrl": "https://api.kiosapi.id",
  "defaultModel": "anthropic/claude-sonnet-4-6"
}

# Atau via env (untuk CI/script)
export KIOSAPI_API_KEY=kios_live_xxxx
kiosapi tanya "halo"

$ kiosapi
buat › bikin endpoint GET /health di Express + tes Jest-nya
buat › @src/routes/auth.ts perbaiki error handler ini
buat › @git:diff ada yang perlu di-refactor?
buat › /commit                  # buat commit git
buat › /diff HEAD~1             # git diff dengan argumen opsional
buat › /shell npm test          # jalankan perintah shell langsung
buat › /model                   # picker model bernomor
buat › /mode rencana            # ganti mode agen
buat › /tim tambah auth JWT     # manajer pilih peran & jalankan
buat › /tim koder perbaiki bug  # jalankan satu peran langsung
buat › /budget 50000            # anggaran token/giliran (agen berhenti bila lewat)
buat › /undo                    # batalkan giliran terakhir (dari riwayat)
buat › /balik                   # kembalikan file yang diubah agen (git)
buat › /ringkas                 # ringkas riwayat (hemat token)
buat › /bantuan                 # daftar semua slash command

buat › @src/routes/auth.ts cek bug di fungsi ini
buat › @src/**/*.test.ts ada tes yang gagal?
buat › @git:diff          # git diff HEAD
buat › @git:status        # git status --short
buat › @git:log           # git log --oneline -10
buat › @git:staged        # git diff --staged

kiosapi tim "bikin endpoint GET /health + tes Jest"   # manajer yang memilih
kiosapi tim --peran koder "perbaiki bug di src/auth.ts"  # langsung ke koder

# model berbeda per peran (atau set di .kiosapi/config.json → "tim")
kiosapi tim "refactor modul auth + tes" \
  --perencana qwen/qwen3-30b \
  --koder     deepseek/deepseek-v4-pro \
  --peninjau  openai/gpt-4o-mini

kiosapi lanjut
# Sesi tim tersimpan ditemukan
#   Tugas    : bikin REST API penuh dengan auth + tes
#   Progress : 3/7 langkah selesai
#   Langkah selesai:
#     ✓ 1. Buat struktur folder + package.json
#     ✓ 2. Implementasi model User + migrasi DB
#     ✓ 3. Endpoint auth (register/login/refresh)
# Lanjutkan? [y/t/n]

# Buat skill di project (.kiosapi/skills/fix-tests.md)
kiosapi skill buat fix-tests

# Buat skill global (-g → ~/.kiosapi/skills/, tersedia di semua proyek)
kiosapi skill buat -g review-security

# Jalankan (argumen masuk ke $ARGUMENTS / {{1}})
kiosapi skill fix-tests
kiosapi skill fix-tests "src/auth/"

# Bawaan + dari sesi interaktif
kiosapi skill review        # tinjau git diff
buat › /skills
buat › /skill fix-tests src/auth/

---
description: Perbaiki semua tes yang gagal dan jalankan ulang
mode: buat              # rencana | edit | buat
# otomatis: true
# model: deepseek/deepseek-v4-flash
# tim: true             # jalankan lewat manajer multi-agen
# peran: koder          # atau satu peran langsung: perencana | koder | peninjau
---

Jalankan tes untuk {{1}} dan perbaiki yang gagal:
- Analisis pesan error  (pakai $ARGUMENTS atau {{1}} {{2}} untuk argumen)
- Perbaiki satu per satu sampai semua lulus
- Jalankan ulang untuk konfirmasi semua hijau

# Anggaran token per tugas — agen berhenti rapi bila terlewat (checkpoint tersimpan)
kiosapi buat --budget 80000 "refactor modul auth"
buat › /budget 50000

# Revert: kembalikan file yang diubah agen pada giliran terakhir (via git)
kiosapi balik        # tracked → HEAD, file baru dihapus (dengan konfirmasi)
buat › /balik

# Scaffold file config
kiosapi mcp init        # buat ~/.kiosapi/mcp.json

# Test koneksi + lihat tools tersedia
kiosapi mcp sambung

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx" }
    }
  }
}

# .kiosapi/config.json — semua kunci opsional
{
  "model": "deepseek/deepseek-v4-flash",
  "mode": "buat",
  "otomatis": false,
  "maxSteps": 60,
  "maxTokens": 80000,
  "projectContext": "REST API Express + TypeScript. Tes di src/__tests__/. Pakai Zod untuk validasi.",
  "tim": {
    "manajer":   "anthropic/claude-sonnet-4-6",
    "perencana": "anthropic/claude-sonnet-4-6",
    "koder":     "deepseek/deepseek-v4-pro",
    "peninjau":  "openai/gpt-4o-mini"
  },
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

kiosapi gambar "logo kopi minimalis, flat design" -o logo.png
kiosapi video "ombak pantai saat senja, sinematik"
kiosapi musik "pop akustik hangat" --lirik "[Verse]\nPagi cerah di kota"
kiosapi musik "instrumental lo-fi santai" --instrumental
kiosapi suara "Selamat datang di Kiosapi!" --suara Indonesian_CalmWoman
kiosapi lihat foto.jpg "ada apa saja di gambar ini?"

kiosapi tanya "ringkas ini" < README.md
kiosapi buat --otomatis "tambah endpoint /health + tes"
kiosapi tanya -m deepseek/deepseek-v4-flash "jelaskan kode" < src/auth.ts
kiosapi gambar "logo kopi minimalis, flat design" -o logo.png