@aigencydev/cli
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/cliNode.js 18.18 veya üzeri gerekir.
node --versionile 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
aigencyKomutlar
| 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
└── .gitignoreKalı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/cliRequires 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
aigencyCommands
| 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.