AIGENCY CLI

Terminalden yapay zeka destekli kod üretimi, dosya yönetimi ve proje otomasyonu. AIGENCY hesabınla bağlanır, projende çalışır, kodu senin onayınla yazar.

┌──────────────────────────────────────────┐
│  ✦ AIGENCY CLI v0.3.0                    │
│  ● default  ·  AIGENCY Pro  ·  my-app    │
│                                          │
│  ▸ Sana nasıl yardımcı olabilirim?       │
└──────────────────────────────────────────┘

Kurulum

npm ile (önerilen)

npm install -g @aigencydev/cli

macOS / Linux — shell installer

curl -fsSL https://aigency.dev/cli/install.sh | bash

Windows — PowerShell

irm https://aigency.dev/cli/install.ps1 | iex

Not: Node.js 18.18 veya üzeri gerekir. node --version ile kontrol edebilirsin.

Hızlı Başlangıç

# 1) Hesabına bağlan (tarayıcı açılır)
aigency login

# 2) Bir proje dizinine gir ve .aigency/ iskeletini oluştur
cd ~/projects/my-app
aigency init

# 3) Ajanla konuşmaya başla
aigency "bana bir Next.js CV sitesi oluştur, Apple tarzı"

# ya da interaktif modda
aigency

Komutlar

Flag'ler:

• --mode <default\|plan\|accept_edits\|auto> — başlangıç izin modu
• --model <pro\|max> — AIGENCY paket seviyesi

İzin Modları

Mod'u çalışırken değiştirmek için Shift+Tab bas.

Kısayollar

Slash Komutları

Araçlar (Ajanın Kullanabildiği Tool'lar)

Ajan projenizde aşağıdaki işlemleri yapabilir (izin modunuza göre onay ister):

Dosya sistemi

• read_file — Dosya içeriği okur
• list_files — Dizin listeler (gitignore'a saygı duyar)
• search_files — Regex ile içerik arar
• write_file — Yeni dosya yazar veya tamamen değiştirir
• edit_file — Mevcut dosyada cerrahi değişiklik yapar

Shell

• bash_execute — İnteraktif olmayan shell komutu çalıştırır (5 dk timeout, canlı çıktı akışı)

Hafıza (kalıcı, makineye özel)

• save_memory — Önemli bilgiyi oturumlar arası sakla
• read_memory — Detay hafıza dosyasını oku
• delete_memory — Artık geçerli olmayan bilgiyi sil

Görev planlama

• write_tasks — Büyük görevleri adımlara böl, ilerlemeyi canlı göster
• read_tasks — Mevcut görev listesini oku

Sandbox: .git/, .env*, ~/.ssh/, node_modules/, .next/ gibi hassas yollar otomatik reddedilir. sudo, rm -rf /, curl | sh gibi tehlikeli komutlar engellenir.

Proje Yapılandırması (.aigency/)

aigency init çalıştırdığında projenizde aşağıdaki yapı oluşturulur:

<proje>/.aigency/
├── AIGENCY.md              # Proje talimatları (ajan her oturum başında okur)
├── PROGRESS.md             # İlerleme takibi (opsiyonel)
├── settings.json           # İzin modu, allow/deny listeleri
├── settings.local.json     # Kişisel override (gitignored)
├── rules/                  # Path-scoped kurallar
│   └── example.md
├── hooks/                  # PreToolUse/PostToolUse script'leri
│   ├── hooks.json
│   └── README.md
├── logs/                   # Günlük JSONL logları (gitignored)
└── .gitignore

AIGENCY.md en önemli dosyadır — projenizin teknoloji yığını, kodlama kuralları, stil tercihleri ve "dokunulmaması gereken yerler"i buraya yazın. Ajan her oturum başında bu dosyayı okur ve yazdığı kod bunlarla hizalanır.

Kalıcı Hafıza ve Oturum Verileri

AIGENCY CLI, makineye özel veriler için kullanıcının home dizininde ayrı bir alan kullanır:

~/.aigency/
├── cli.json                # Auth metadata
├── credentials.enc         # AES-256-GCM şifreli token'lar
├── settings.json           # Kullanıcı seviyesi ayarlar
├── AIGENCY.md              # Tüm projelerde geçerli global talimatlar
├── cli.log                 # Rotating log (5 MB × 3 yedek)
├── cache/                  # LLM response, hash cache
├── temp/                   # Oturum scratch alanı
└── projects/
    └── <proje-hash>/       # Git remote veya yola göre hash
        ├── memory/
        │   ├── MEMORY.md   # Hafıza index'i
        │   ├── user_*.md   # Kullanıcı hakkında
        │   ├── feedback_*.md # Davranış kuralları
        │   ├── project_*.md  # Proje bağlamı
        │   └── reference_*.md # Harici kaynak pointer'ları
        ├── sessions/
        │   └── <id>.jsonl  # Oturum transkriptleri
        └── checkpoints/    # Dosya edit snapshot'ları (undo için)

Bu alan git'e commit edilmez ve senkronize de olmaz — her makinede ayrı. .aigency/ (proje klasörü) ise git'e eklenebilir, takımla paylaşılır.

Paketler

Paketleri aigency.dev/developer/cli üzerinden yönetebilir, kullanımınızı canlı izleyebilirsiniz.

Yapılandırma

Ortam değişkenleri

.aigency/settings.json Örneği

{
  "permissions": {
    "defaultMode": "default",
    "allow": [
      "Read(**/*)",
      "Bash(npm run *)",
      "Bash(git status)"
    ],
    "ask": [
      "Write(**/*)",
      "Edit(**/*)",
      "Bash(*)"
    ],
    "deny": [
      "Read(.env)",
      "Write(.git/**)",
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  },
  "memory": {
    "enabled": true
  },
  "hooks": {
    "enabled": false
  }
}

Geliştirme (Contributing)

git clone https://github.com/aigencydev/cli.git
cd cli
npm install

npm run dev -- help      # tsx ile direkt çalıştır
npm run typecheck        # TypeScript tip kontrolü
npm run test             # Vitest
npm run build            # dist/ üret

Destek

• Web: aigency.dev/developer/cli
• Tanıtım: aigency.dev/forge
• Sorun / öneri: aigency.dev/contact

Lisans

Özel — AIGENCY. Tüm hakları saklıdır.