CLI'de Agent Kullanımı

Modlar

CLI, editörle aynı modları destekler. Slash komutları veya --mode bayrağıyla modlar arasında geçiş yapabilirsiniz.

Plan modu

Kodlamaya başlamadan önce yaklaşımınızı planlamak için Plan modunu kullanın. Agent, planınızı netleştirmek için açıklayıcı sorular sorar.

• Plan moduna geçmek için Shift+Tab tuşlarına basın
• Plan moduna geçmek için /plan kullanın
• --plan veya --mode=plan bayrağıyla başlatın

Ask modu

Kodda değişiklik yapmadan inceleme yapmak için Ask modunu kullanın. Agent, kod tabanınızda arama yapar ve dosyaları düzenlemeden yanıtlar sunar.

• Ask moduna geçmek için /ask kullanın
• --mode=ask bayrağıyla başlatın

İstem Yazma

En iyi sonuçlar için niyetinizi açıkça belirtmeniz önerilir. Örneğin, Agent'ın hiçbir dosyayı düzenlememesini sağlamak için "hiç kod yazma" istemini kullanabilirsiniz. Bu, özellikle görevleri uygulamadan önce planlarken faydalıdır.

Agent; dosya işlemleri, arama, shell komutlarını çalıştırma ve web'e erişim için araçlara sahiptir.

MCP

Agent, gelişmiş işlevsellik ve entegrasyonlar için MCP'yi (Model Context Protocol) destekler. CLI, mcp.json yapılandırma dosyanızı otomatik olarak algılar ve bu dosyadaki ayarlara uyar; böylece editör için yapılandırdığınız MCP sunucularını ve araçları kullanabilirsiniz.

ACP

Agent, özel istemci entegrasyonları için ACP'yi (Agent Client Protocol) de destekler. Cursor CLI'yi JSON-RPC mesajlaşması kullanarak stdio üzerinden ACP sunucusu olarak çalıştırmak için agent acp komutunu kullanın.

Kurallar

CLI agent'i, editörle aynı kural sistemini destekler. Agent'e bağlam ve yönlendirme sağlamak için .cursor/rules dizininde kurallar oluşturabilirsiniz. Bu kurallar, yapılandırmalarına göre otomatik olarak yüklenir ve uygulanır. Böylece projenizin farklı bölümleri veya belirli dosya türleri için agent'in davranışını özelleştirebilirsiniz.

Agent ile çalışma

Gezinme

Yukarı ok tuşuyla (ArrowUpArrow Up) önceki mesajlara erişebilir ve aralarında gezinebilirsiniz.

Girdi kısayolları

• Shift+Tab — Modlar (Agent, Plan, Ask) arasında geçiş yapın
• Shift+Enter — Göndermek yerine yeni satır ekler; çok satırlı istemler yazmayı kolaylaştırır.
• Ctrl+D — CLI'dan çıkın. Standart shell davranışına uygun olarak, çıkmak için iki kez basılması gerekir.
• Ctrl+J veya +Enter — Tüm terminallerde çalışan, yeni satır eklemek için evrensel alternatifler.

Gözden Geçirme

Değişiklikleri Ctrl+R ile gözden geçirin. Takip talimatları eklemek için i tuşuna basın. Kaydırmak için ArrowUpArrow Up/ArrowDownArrow Down, dosyalar arasında geçiş yapmak için ise ArrowLeftArrow Left/ArrowRightArrow Right tuşlarını kullanın.

Bağlam seçimi

@ ile bağlama dahil etmek istediğiniz dosya ve klasörleri seçin. /summarize komutunu çalıştırarak bağlam penceresinde yer açın. /compress ise takma ad olarak kullanılmaya devam eder.

Cloud Agent'e aktarma

Konuşmanızı bir Cloud Agent'e push edin; siz uzaktayken çalışmaya devam etsin. Buluta göndermek için herhangi bir mesajın başına & ekleyin. cursor.com/agents üzerinden web veya mobilde kaldığınız yerden devam edin.

# Konuşma sırasında Cloud Agent'a bir görev gönderin& refactor the auth module and add comprehensive tests

CLI worktree'leri

Agent'i mevcut checkout'unuzu doğrudan düzenlemek yerine yeni bir Git worktree'sinde çalıştırmak için -w veya --worktree [name] seçeneğini kullanın. Cursor, bu checkout'ları editörden oluşturulan worktree'lerin yanında ~/.cursor/worktrees/<reponame>/<name> altında oluşturur. name belirtilmezse Cursor bir ad oluşturur.

Cursor, CLI worktree'lerini editör worktree'leri için kullandığı saklama kurallarıyla temizler. Temizleme ayarları ve limitleri için bkz. Eski worktree'ler nasıl temizlenir?.

Açıkça bir depo kökü belirtmeniz gerektiğinde --workspace <path> seçeneğini ekleyin. Aksi takdirde CLI mevcut çalışma dizinini kullanır. --worktree yalnızca agent'in bu proje içinde dosya düzenlemelerini yaptığı konumu değiştirir.

# Geçerli depodan otomatik oluşturulan bir adla geçici bir worktree oluşturunagent --worktree "upgrade the test runner and fix any broken snapshots"# Başka bir depodan adlandırılmış bir worktree oluşturunagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

Geçmiş

Önceki bağlamı yüklemek için --resume [thread id] ile mevcut bir konuşmayı sürdürün.

En son konuşmayı sürdürmek için agent resume, --continue veya /resume slash komutunu kullanın.

Önceki sohbetleri açıp birini sürdürmek için agent ls komutunu da çalıştırabilirsiniz.

Komut onayı

CLI, terminal komutlarını çalıştırmadan önce yürütmeyi onaylamanızı (y) veya reddetmenizi (n) ister.

Etkileşimsiz mod

Agent'i etkileşimsiz modda çalıştırmak için -p veya --print kullanın. Yanıt konsola yazdırılır.

Etkileşimsiz modda Agent'i etkileşimsiz olarak çağırabilirsiniz. Bu sayede Agent'i betiklere, CI işlem hatlarına vb. entegre edebilirsiniz.

Çıktının nasıl biçimlendirileceğini kontrol etmek için bunu --output-format ile birleştirebilirsiniz. Örneğin, betiklerde daha kolay ayrıştırılabilen yapılandırılmış çıktı için --output-format json, agent'in nihai yanıtını düz metin olarak almak için ise --output-format text kullanın.