Uygulamayı aç
Moonborn — Developers

CLI (komut satırı arayüzü)

Moonborn komut satırı arayüzü — `moonborn` ikilisi (binary). Kimlik doğrulama, persona, sohbet, webhook, yapılandırma, MCP stdio köprüsü. Global kur, terminalden çalışma alanını sür.

@moonborn/cli — kanonik komut satırı arayüzüdür (CLI). Global kur, bir kez oturum aç, sonra terminalden çalışma alanını sür. Her API sürümüyle yayımlanır; SDK'lara sürüm uyumludur.

Pratik kullanım: CI betikleri, anlık (ad-hoc) sorgular, MCP stdio köprüsü (HTTPS yerine stdio'yu tercih eden geliştirme ortamları — IDE'ler — için).

Bu sayfayı bitirdiğinde

  • CLI'yı kurabilecek ve kimlik doğrulayabileceksin.
  • Persona, sohbet, webhook, yapılandırma komutlarını uçtan uca kullanabileceksin.
  • --json ile betiklenebilir (scriptable) çıktı üretebileceksin.
  • Çalışma alanı değiştirme + MCP stdio köprüsü desenlerini uygulayabileceksin.

Ön koşul: Node.js 18+ (CLI npm üzerinden yayımlanır).

Kurulum

npm i -g @moonborn/cli

Doğrula:

moonborn --version
# → moonborn/1.4.0 (api: 1.4.x)

Kimlik doğrulama

moonborn login

Tarayıcını açar → OAuth akışı → çalışma alanı kapsamlı API anahtarını ~/.config/moonborn/credentials dosyasına düşürür.

Mevcut API anahtarını doğrudan kullanmak:

export MOONBORN_API_KEY=sk_live_...
moonborn personas list

CLI önce ortam değişkenini kontrol eder, sonra kimlik bilgileri (credentials) dosyasına yedeklenir.

Komutlar

Personas

# Listele
moonborn personas list
moonborn personas list --workspace ws_... --status published --limit 20
 
# Oluştur
moonborn personas create --intent "..." --workspace ws_...
 
# Getir
moonborn personas get per_01H...
 
# Refine et
moonborn personas refine per_01H... --mode refine --layer mask --axis warmer --amount 0.4
 
# Fork et
moonborn personas fork per_01H... --note "DE locale variant"
 
# Arşivle
moonborn personas archive per_01H...

Sohbet (chat)

# Yeni oturum
moonborn chat start --persona per_01H...
 
# Mesaj gönder
moonborn chat send ses_01H... "Seni ne tetikler?"
 
# Etkileşimli (REPL) mod
moonborn chat repl --persona per_01H...

Webhook'lar

# Listele
moonborn webhooks list
 
# Oluştur
moonborn webhooks create \
  --url https://your-app.com/webhooks/moonborn \
  --events persona.created,persona.audit_failed
 
# Ping (bağlantı testi)
moonborn webhooks ping wh_01H...
 
# Başarısız teslimi yeniden oynat
moonborn webhooks deliveries replay wh_01H... del_01H...

Yapılandırma (config)

# Oku
moonborn config get engine.pipeline.drift_detection.threshold
moonborn config get engine.pipeline.drift_detection.threshold --scope workspace
 
# Yaz (kapsam — scope — zorunlu)
moonborn config set engine.pipeline.drift_detection.threshold 0.20 --scope workspace
 
# Kilitle
moonborn config lock engine.pipeline.drift_detection.threshold --scope org
 
# Anlık görüntü (snapshot) + geri alma (rollback)
moonborn config snapshot --scope workspace
moonborn config rollback snap_01H...

MCP stdio köprüsü

HTTPS yerine stdio MCP taşıma katmanını (transport) tercih eden geliştirme ortamları için:

moonborn mcp --stdio

Claude Desktop yapılandırması (örnek):

{
  "mcpServers": {
    "moonborn": {
      "command": "moonborn",
      "args": ["mcp", "--stdio"]
    }
  }
}

Detay: MCP sunucusu.

Yardım

Tüm komutların seçenek setini görmek için:

moonborn --help
moonborn personas --help
moonborn personas refine --help

Betiklenebilir çıktı — --json

Her komut --json destekler:

PERSONA_ID=$(moonborn personas create --intent "..." --workspace ws_... --json | jq -r .id)
moonborn chat start --persona "$PERSONA_ID" --json | jq -r .id > session.txt

jq ile ayrıştır, bash / zsh ile zincirle — üretim CI betikleri için idealdir.

Çıkış kodları (exit codes) — Unix sözleşmesi

0    başarı
1    genel hata (ağ, dosya vb.)
2    geçersiz argümanlar / eksik zorunlu seçenek
3    kimlik doğrulama hatası (unauthorized / forbidden)
4    hız limiti aşıldı (rate limited)
5    doğrulama başarısız

CI betiği:

if ! moonborn personas create --intent "..." --json > /tmp/persona.json; then
  case $? in
    3) echo "auth issue" >&2 ;;
    4) echo "rate limited; back off" >&2 ;;
    5) echo "invalid intent" >&2 ;;
    *) echo "unknown error" >&2 ;;
  esac
  exit 1
fi

Çalışma alanı değiştirme

# Listele
moonborn workspace list
 
# Aktif çalışma alanını seç (CLI çağrıları arasında kalıcı)
moonborn workspace use ws_abc...
 
# Tek seferlik geçersiz kılma
moonborn personas list --workspace ws_other...

Sık karşılaşılan hatalar

command not found: moonborn

CLI global olarak yüklenmedi veya PATH'te değil. npm i -g @moonborn/cli yeniden çalıştır veya npx moonborn ... ile çalıştır.

EACCES: permission denied

Global kurulum izin sorunu. sudo yerine npm önekini kullanıcı dizinine taşı:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# Sonra ~/.zshrc'ye: export PATH=~/.npm-global/bin:$PATH

MCP server not responding (stdio modu)

Claude Desktop yapılandırmasında command: "moonborn" çalışıyor mu kontrol et — terminalde moonborn mcp --stdio etkileşimli mod açıyor mu?

Plan gereksinimi

Her plan — API ile aynı kimlik doğrulama + plan başına kapılar sunucu tarafında uygulanır.

İlgili

TypeScript SDK

Uygulama içi kod için.

Open →
MCP sunucusu

HTTPS modlu IDE entegrasyonu — stdio alternatifi.

Open →
Yetki kapsamları (scopes)

moonborn login ile çıkan anahtarın yetki kapsamları.

Open →
API sürümleme politikası

CLI ↔ API sürüm uyumluluğu.

Open →