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.

Kurulum

npm install -g @aigencydev/cli

Node.js 18.18 veya üzeri gerekir. node --version ile kontrol edebilirsiniz.

Hızlı Başlangıç

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

# 2) Proje dizinine girin ve .aigency/ iskeletini oluşturun
cd ~/projects/my-app
aigency init

# 3) Ajanla konuşmaya başlayın
aigency "bana bir Next.js CV sitesi oluştur"

# ya da interaktif modda
aigency

Komutlar

| Komut | Açıklama | |---|---| | aigency | İnteraktif sohbet modu | | aigency "<prompt>" | Tek seferlik prompt çalıştır | | aigency login | AIGENCY hesabına bağlan | | aigency logout | Oturumu kapat | | aigency init | Mevcut dizinde .aigency/ kur | | aigency usage | Aylık token kullanımını göster | | aigency update | Sürüm kontrolü | | aigency mcp | MCP server modunda başlat (IDE entegrasyonu) | | aigency help | Yardım | | aigency --version | Sürümü göster | | aigency --mode plan | Plan modunda başlat (dry-run) | | aigency --mode accept_edits | Düzenlemeleri otomatik kabul | | aigency --continue | Son oturumdan devam et | | aigency --resume <id> | Belirli oturuma dön |

Slash Komutları

| Komut | İşlev | |---|---| | /help | Komut listesi | | /clear | Sohbet geçmişini temizle | | /mode [mod] | İzin modunu değiştir veya göster | | /cost | Bu oturumda kullanılan token | | /undo | Son dosya düzenlemesini geri al | | /continue | Kaldığın yerden devam et | | /docs <framework> <konu> | Dokümantasyon ara | | /components | Kurulu shadcn/ui bileşenlerini göster | | /exit | Çıkış |

Kısayollar

| Tuş | İşlev | |---|---| | Shift+Tab | İzin modlarını döngüle | | ESC | Aktif işlemi iptal et | | Ctrl+C | Çalışıyorsa iptal, boştaysa çıkış |

İzin Modları

| Mod | Davranış | |---|---| | default | Okuma otomatik, yazma ve komut için onay sorulur | | plan | Dry-run — hiçbir şey yazılmaz, sadece plan gösterilir | | accept_edits | Dosya yazma otomatik, komutlar onay ister | | auto | Tam otomatik (yalnızca Max paket) |

Araçlar

Ajan projenizde 19 farklı araçla çalışabilir:

Dosya sistemi: read_file · list_files · search_files · write_file · edit_file · edit_file_multi

Shell: bash_execute — interaktif olmayan komutlar, 5 dk timeout, canlı çıktı

Doğrulama: verify_project · check_dependencies — proje ve sistem sağlık kontrolü

Hafıza: save_memory · read_memory · delete_memory — oturumlar arası kalıcı

Görev planlama: write_tasks · read_tasks — canlı ilerleme göstergesi

Self-check: assert_done — görev tamamlama doğrulaması

Dokümantasyon: docs_lookup — framework dokümantasyonu çekme (Next.js, React, Tailwind, vb.)

Bileşenler: list_components ��� shadcn/ui bileşen tarama

Güvenlik: .git/, .env*, ~/.ssh/, node_modules/ yazma yasak. sudo, rm -rf /, curl | sh otomatik engellenir.

Proje Şablonları

15 farklı proje tipi için production-ready referans şablon:

| Şablon | Açıklama | |---|---| | CV / Portföy | Apple-tarzı kişisel site | | Dashboard | Admin paneli (sidebar, KPI, tablo) | | E-ticaret | Ürün grid, sepet, kategori | | Landing / SaaS | Hero, feature, pricing, FAQ | | CRM | Müşteri yönetimi, pipeline | | Muhasebe | Fatura listesi, KPI, raporlar | | Envanter | Stok yönetimi, uyarılar | | Rezervasyon | Takvim, randevu sistemi | | Kanban | Proje yönetim board'u | | Blog | Yazı grid, kategori, newsletter | | Chat | Mesajlaşma uygulaması | | E-learning | Kurs platformu | | Mobil Uygulama | App Store tanıtım sayfası | | REST API | Express.js backend + docs | | Genel | Nötr başlangıç şablonu |

Kullanıcı ne isterse ilgili şablon otomatik seçilir ve ajanın prompt'una enjekte edilir.

MCP Desteği

AIGENCY CLI hem MCP server hem MCP client olarak çalışabilir:

Server: aigency mcp komutuyla başlatılır. IDE extension'lar (VS Code, Cursor) AIGENCY'nin araçlarına MCP protokolü ile erişebilir.

Client: settings.json'da MCP server'lar tanımlanır, ajan bu server'ların araçlarını kullanabilir.

{
  "mcp": {
    "servers": [
      {
        "name": "sqlite",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "./data.db"]
      }
    ]
  }
}

Proje Yapılandırması

aigency init ile projenizde oluşturulur:

.aigency/
├── AIGENCY.md          # Proje talimatları (her oturumda okunur)
├── settings.json       # İzin modu, MCP, allow/deny listeleri
├── rules/              # Dosya bazlı kurallar
├── hooks/              # PreToolUse/PostToolUse script'leri
└── .gitignore

Kalıcı Veriler

~/.aigency/
├── cli.json            # Auth metadata
├── credentials.enc     # Şifreli token'lar (AES-256-GCM)
├── settings.json       # Global ayarlar
├── cli.log             # Rotating log
└── projects/<hash>/
    ├── memory/         # Kalıcı hafıza (MEMORY.md + topic dosyaları)
    ├── sessions/       # Oturum transkriptleri (JSONL)
    └── checkpoints/    # Dosya edit snapshot'ları (/undo için)

Makineye özel, git'e eklenmez.

Paketler

| Paket | Fiyat | Aylık Token | Ek Özellikler | |---|---|---|---| | CLI Pro | 1.500 ₺/ay | 100.000.000 | Standart | | CLI Max | 3.000 ₺/ay | 500.000.000 | Öncelikli kuyruk, Auto mode |

Yapılandırma

| Değişken | Açıklama | |---|---| | AIGENCY_CLI_API_URL | API adresi (varsayılan: https://aigency.dev) | | AIGENCY_CLI_DEBUG | 1 ile debug loglar |

Destek

• aigency.dev/developer/cli — Yönetim paneli
• aigency.dev/forge — Tanıtım ve SSS
• aigency.dev/contact — İletişim

Lisans

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

AIGENCY CLI (English)

AI-powered code generation, file management and project automation from your terminal. Connect with your AIGENCY account, work in your project, code is written with your approval.

Installation

npm install -g @aigencydev/cli

Requires Node.js 18.18 or higher.

Quick Start

# 1) Sign in (opens browser)
aigency login

# 2) Navigate to your project and create .aigency/ scaffold
cd ~/projects/my-app
aigency init

# 3) Start chatting with the agent
aigency "create a Next.js CV site for me"

# or interactive mode
aigency

Commands

| Command | Description | |---|---| | aigency | Interactive chat mode | | aigency "<prompt>" | One-shot prompt | | aigency login | Sign in to AIGENCY | | aigency logout | Sign out | | aigency init | Create .aigency/ scaffold | | aigency usage | Show monthly token usage | | aigency update | Check for updates | | aigency mcp | Start as MCP server (IDE integration) | | aigency help | Help | | aigency --version | Show version | | aigency --mode plan | Start in plan mode (dry-run) | | aigency --continue | Resume last session | | aigency --resume <id> | Resume specific session |

Slash Commands

| Command | Action | |---|---| | /help | Command list | | /clear | Clear chat history | | /mode [mode] | Change or show permission mode | | /cost | Tokens used this session | | /undo | Revert last file edit | | /continue | Resume from where you left off | | /docs <framework> <topic> | Fetch documentation | | /components | Show installed shadcn/ui components | | /exit | Exit |

Tools

The agent has 19 tools at its disposal:

Filesystem: read_file · list_files · search_files · write_file · edit_file · edit_file_multi

Shell: bash_execute — non-interactive commands, 5 min timeout, live output streaming

Verification: verify_project · check_dependencies — project and system health checks

Memory: save_memory · read_memory · delete_memory — persistent across sessions

Task planning: write_tasks · read_tasks — live progress indicator

Self-check: assert_done — task completion verification

Documentation: docs_lookup — fetch framework docs (Next.js, React, Tailwind, etc.)

Components: list_components — scan shadcn/ui components

Security: .git/, .env*, ~/.ssh/, node_modules/ are write-protected. sudo, rm -rf /, curl | sh are automatically blocked.

Project Templates

15 production-ready reference templates for different project types — CV, Dashboard, E-commerce, Landing/SaaS, CRM, Accounting, Inventory, Booking, Kanban, Blog, Chat, E-learning, Mobile App, REST API, and a generic starter. The matching template is automatically injected based on the user's request.

MCP Support

AIGENCY CLI works as both MCP server and client:

Server: Run aigency mcp to start. IDE extensions (VS Code, Cursor) can access AIGENCY tools via MCP protocol.

Client: Define MCP servers in settings.json — the agent can use tools from external MCP servers.

Plans

| Plan | Price | Monthly Tokens | Extras | |---|---|---|---| | CLI Pro | 1,500 TRY/mo | 100,000,000 | Standard | | CLI Max | 3,000 TRY/mo | 500,000,000 | Priority queue, Auto mode |

Configuration

| Variable | Description | |---|---| | AIGENCY_CLI_API_URL | API address (default: https://aigency.dev) | | AIGENCY_CLI_DEBUG | Set 1 for debug logs |

Support

• aigency.dev/developer/cli — Dashboard
• aigency.dev/forge — Product page & FAQ
• aigency.dev/contact — Contact

License

Proprietary — AIGENCY. All rights reserved.