İçeriğe atla
Ücretsiz ve açık kaynak

Dokümanlar

Yapay zekâ asistanları kodlama görevlerini yürütür. Bu kılavuz komut satırı araçlarını (CLI), terminal menülerini (TUI), görevleri çalışır tutan terminal aracı tmux’u ve yapay zekâ araçları arasındaki standart bağlantı MCP’yi açıklar.

Kurulum

macOS, Linux ya da WSL, Node 22.12 veya daha yenisi, tmux 3.0 veya daha yenisi ve kurulu, girişi yapılmış en az bir sağlayıcı CLI'si gerekir.

$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagents
reevesagents doctor bunların hepsini kontrol eder. reevesagents setup aynı kontrolleri ilk çalıştırma sihirbazı olarak yapar ve --attach ile MCP'yi kurulu tüm ana araçlara da bağlar.

Hızlı başlangıç

Bir takım başlatın, durumuna bakın, gerekince araya girin ve durdurun.

Takımı başlatın

shell
reevesagents spawn cc:lead codex:api kimi:docs \
  --name "feature x" --prompt "Build feature X. The lead splits the work."

Her asistan provider[:nickname[:model]] biçiminde tanımlanır. İlk yazılan asistan takımı yönetir. Son çalışma oturumuna asistan eklemek için reevesagents add kullanın.

İzleyin ve yönlendirin

shell
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open api

send metni yalnızca yapıştırır. Göndermek için ardından key <agent> enter çalıştırın. open sizi tmux içinde o asistana götürür.

Durdurun

shell
reevesagents stop "feature x" --yes
stop, kill ve delete komutları çalışmak için --yes (ya da ALLOW_DESTRUCTIVE=1) ister.

Terminal menüsü, tarayıcı ve komutlar

Menü (TUI), tarayıcı arayüzü ve komut satırı aracı (CLI), ~/.reeves altındaki görev kayıtlarını paylaşır. Terminal aracı tmux, asistanları çalışır tutar.

  • Argümansız reevesagents yazınca TUI açılır. Kendini reeves adlı bir tmux oturumuna sarar; REEVES_NO_TMUX_WRAPPER=1 bunu kapatır.
  • reevesagents web, Web UI sunucusunu 127.0.0.1 üzerinde, 8080 portunda ya da sıradaki boş portta başlatır. Yerel adres dışındaki Host başlıklarını ve başka sitelerden gelen yazma isteklerini reddeder. Ctrl+C sunucuyu durdurur, asistanlarınız çalışmaya devam eder.
  • Her şey aynı zamanda bir CLI komutudur. Düz metin çıktısı sürümler arasında değişebilir, bu yüzden betikler --json okumalı.
  • Altta tmux çalışır: her çalışma oturumu için bir oturum, her asistan için bir pencere. reevesagents open <id> nerede olursanız olun sizi doğru pencereye götürür.

Agent Kontrolü (MCP)

Bir kodlama aracını diğerlerine standart protokol MCP ile bağlayın. Bu isteğe bağlıdır. Bağladıktan sonra aracı yeniden başlatın.

shell
reevesagents attach cc
reevesagents hosts
  • Altı kodlama aracı bu bağlantıyı kullanabilir: Claude Code, Codex, Kimi Code, Qwen Code, Hermes ve OpenCode. reevesagents attach, ad verilmezse kurulu araçların hepsine bağlanır. reevesagents detach <cli> bağlantıyı kaldırır.
  • Bağlanan araç; asistan başlatabilir, metin yapıştırabilir, tuşa basabilir, çıktı okuyabilir ve onayları yönetebilir. Takımın görevlerini bu araca istem yazan kişi belirler.
  • Yeni asistanlar bu araçları yalnızca kendi kodlama araçları da bağlandığında alır. MCP üzerinden başlatmada max_agents (varsayılan 100), çalışma oturumu başına asistan sınırını belirler.

Komutlar

Bütün reevesagents alt komutları. Argümansız çalıştırınca TUI açılır.

Çalışma oturumları

spawn [spec...]

Bir run başlatır. Her spec provider[:nickname[:model]] biçimindedir ve ilk yazılan lead olur. Flag'ler: --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

En son aktif run'a agent ekler. Flag'ler: --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. En az bir spec gerekir.

runs

Aktif run'ları listeler. --json.

open <id>

tmux içinde bir run'ın ya da agent'ın penceresine geçer. Id, ad, takma ad veya benzersiz bir önek kabul eder.

peek <agent-id>

Bir agent'ın son çıktısını yazdırır. -n/--lines (varsayılan 20), --json.

stop <run-id>--yes ister

Bir run'ı durdurur ve tmux oturumunu kapatır. -y/--yes.

kill <agent-id>--yes ister

Bir agent'ı durdurur. Run, son aktif agent'la birlikte biter. -y/--yes.

Bir asistanı yönetme

send <agent-id> <text...>

Metni agent'ın prompt'una yapıştırır, göndermez.

key <agent-id> <key>

İzin verilen tek bir tuşu gönderir: enter, escape, backspace, tab, space, up, down, left, right, ctrl-c.

interrupt <agent-id>

ctrl-c gönderir.

Kayıtlar ve geçmiş

agents [run-id]

Aktif run'lardaki ya da belirtilen run'daki agent'ları listeler. --json.

providers

Sağlayıcıları, kullanılabilirliklerini ve bilinen modellerini listeler. --models, --json.

tools

Agent araçlarını kurulum ve giriş durumlarıyla listeler. --json.

delete <agent-id>--yes ister

Sona ermiş bir agent'ın kaydını siler. -y/--yes.

delete-run <run-id>--yes ister

Sona ermiş bir run'ı siler. -y/--yes.

history

Arşivlenmiş run geçmişini listeler. --json.

delete-history <id>--yes ister

Bir geçmiş kaydını siler. -y/--yes.

Onaylar

approvals

Bekleyen onayları listeler. --json.

approve <approval-id> [note]

Bir onay isteğini onaylar.

deny <approval-id> [note]

Bir onay isteğini reddeder.

MCP ana araçları

hosts

MCP destekleyen host CLI'leri ve hangilerine bağlı olduğunu listeler. --json.

attach [cli]

MCP'yi bir host CLI'ye ya da kurulu tüm host'lara, o CLI'nin kendi komutu veya config dosyası üzerinden bağlar. --force mevcut kaydın üzerine yazar.

detach <cli>

MCP'yi bir host CLI'den, o CLI'nin kendi komutu veya config dosyası üzerinden ayırır.

mcp

Agent Kontrolü MCP sunucusunu stdio üzerinden başlatır. Bunu host CLI çalıştırır.

Ayarlar ve ön ayarlar

config [key] [value]

Düzenlenebilir bir config alanını gösterir, okur veya ayarlar. --json.

presets

Kayıtlı ön ayarları listeler. --json.

save-preset <run-id> <name> [description...]

Çalışan bir run'ı ön ayar olarak kaydeder.

start-preset <name>

Bir ön ayardan run başlatır. --name, --cwd.

delete-preset <name>--yes ister

Bir ön ayarı siler. -y/--yes.

Kurulum ve araçlar

setup

tmux'ı, Node'u ve kurulu CLI'leri ilk çalıştırmada kontrol eder. --attach kurulu tüm host'ları bağlar. --json onboarding durumunu bildirir.

doctor

Ortamın sağlık kontrollerini çalıştırır. Başarısız olursa sıfırdan farklı kodla çıkar. --json.

skills [action]

ReevesAgents skill'ini skill destekleyen CLI'ler için kurar, kaldırır veya kontrol eder (install, remove, status; varsayılan status). --json.

reap

Penceresi kaybolmuş ya da max_lifetime_ms değerini aşmış agent'ları sonlandırır ve sahipsiz tmux oturumlarını kapatır. --json.

web

Yalnızca loopback üzerinde dinleyen Web UI'yi ön planda başlatır. --port, --no-open.

MCP araçları

Bağlı bir CLI'nin çağırabildiği 31 araç, amaçlarına göre gruplanmış halde.

Başlatma ve yönetme

spawnzorunluprovideristeğe bağlırun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

Bir worker başlatır. run_id verilmezse bu MCP oturumunun ilk spawn'da oluşturulan run'ı kullanılır. run_id verilirse başka bir run hedeflenir.

killzorunluagent_id

Bir agent'ı durdurur.

stopzorunlurun_id

Bir run'ın tamamını durdurur ve tmux oturumunu kapatır.

send_textzorunluagent_idtext

Metni bir agent'ın prompt'una yapıştırır, göndermez.

send_keyzorunluagent_idkey

İzin verilen tek bir tuşu gönderir (enter, escape, ctrl-c, …).

interruptzorunluagent_id

Bir agent'a ctrl-c gönderir.

readzorunluagent_idisteğe bağlılines

Son pane çıktısını okur; ANSI kodları ayıklanır, gizli bilgiler maskelenir. Varsayılan: 20 satır.

İnceleme

list

Run'ları ve agent'ları listeler.

list_providers

Bu makinenin sağlayıcı ve model kataloğu.

list_tools

Bu makinenin araç kataloğu: bir agent'ın kendi kabuğundan çalıştırabileceği yardımcı CLI'ler, kurulum ve giriş durumlarıyla.

list_history

Arşivlenmiş run'lar.

list_presets

Kayıtlı ön ayarlar.

list_hosts

MCP destekleyen CLI'ler ve hangilerine bağlı olduğu.

get_config

Geçerli genel config.

doctor

Ortam sağlık kontrolleri.

Onaylar

request_approvalzorunluagent_idactionsummaryisteğe bağlıdetailsrisk

Bir onay isteği oluşturur.

resolve_approvalzorunluapproval_iddecisionisteğe bağlınote

Bekleyen bir isteği onaylar ya da reddeder.

check_approvalzorunluapproval_id

Bir onay isteğini okur.

list_approvalsisteğe bağlırun_idstatus

Onayları listeler, filtrelenebilir.

Yaşam döngüsü

deletezorunluagent_id

Sona ermiş bir agent'ın kaydını siler.

delete_runzorunlurun_id

Sona ermiş bir run'ı siler.

delete_historyzorunluid

Bir geçmiş kaydını siler.

openzorunluid

Bağlı tmux istemcisini bir run'a ya da agent'a geçirir.

reap

Penceresi kaybolmuş veya ömrünü aşmış agent'ları ve sahipsiz tmux oturumlarını hemen süpürür.

Ayarlar ve ön ayarlar

set_configisteğe bağlıpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguage

Düzenlenebilir bir veya daha fazla config alanını ayarlar.

save_presetzorunlurun_idnameisteğe bağlıdescription

Çalışan bir run'ı ön ayar olarak kaydeder.

start_presetzorunlunameisteğe bağlırun_nameworking_dir

Bir ön ayardan run başlatır.

delete_presetzorunluname

Bir ön ayarı siler.

Ana araçlar ve skill'ler

attach_hostisteğe bağlıkey

MCP'yi bir host CLI'ye ya da hepsine bağlar.

detach_hostzorunlukey

MCP'yi bir host CLI'den ayırır.

install_skillsisteğe bağlıstatus

ReevesAgents skill'ini skill destekleyen CLI'ler için kurar ya da nerede olduğunu bildirir.

Sağlayıcı kataloğu ve bir kullanım rehberi iki kaynakta durur: reevesagents://providers, reevesagents://guide

Yapılandırma

Ayarlar ~/.reeves/config.json dosyasında durur. Birini reevesagents config <key> <value> ile ya da ayar ekranlarından değiştirin. reevesagents config language tr arayüzü on dilden birine geçirir.

Alanlar

peek_interval_ms5000

Kayıtlı sorgulama aralığı ayarı. Mevcut arayüzler sabit yenileme aralıkları kullanır.

peek_lines10

Kayıtlı çıktı satırı ayarı. Mevcut ekranlar ile CLI/MCP okumaları kendi satır sayılarını kullanır.

max_agents100

Run başına canlı agent üst sınırı; MCP spawn bunu uygular. Diğer başlatma yolları uygulamaz.

max_depth5

Kayıtlı özyineleme derinliği ayarı. Mevcut run motoru bunu uygulamaz.

ready_delay_ms5000

Yeni bir CLI'nin oturması için, prompt yapıştırılmadan önce beklenen süre.

max_lifetime_ms0

Bundan eski agent'ları temizler. 0 bunu kapatır.

default_permissionsask

Yeni agent'lar için varsayılan izin modu: ask veya skip.

languageen

Arayüz dili, on dil kodundan biri.

Diskteki durum

~/.reeves/
  config.json
  presets/<name>.json
  runs/<run-id>/
    run.json
    agents/<agent-id>.json
    approvals/<approval-id>.json
  history/runs/<run-id>.json

Ortam değişkenleri

REEVES_REGISTRY

Durum kök dizinini değiştirir (varsayılan ~/.reeves).

REEVES_CONFIG

Config dosyasının yolunu değiştirir.

REEVES_NO_TMUX_WRAPPER=1

1 olduğunda TUI'yi otomatik olarak bir tmux oturumuna sarmaz.

REEVES_NO_COLOR=1

1 olduğunda TUI renklerini kapatır.

ALLOW_DESTRUCTIVE=1

1 olduğunda yıkıcı komutlar --yes olmadan çalışır.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

1 olduğunda doctor, sağlayıcı uyumluluk kontrolünü atlar.

Sağlayıcılar

25 kodlama aracının her biri için başlatma komutunda kullanılan kısa bir kimlik vardır. Model listeleri öneridir; verdiğiniz model kimliği doğrudan sağlayıcıya iletilir.

  • Claude CodeMCP ana araç

    Anthropic’in terminal için kodlama ajanı

    id ccbinary claude

    önerilen modeller fable, opus, sonnet, haiku

  • Codex CLIMCP ana araç

    OpenAI’ın CLI kodlama ajanı

    id codexbinary codex

    önerilen modeller gpt-5.6-sol, gpt-5.5, gpt-5.4-mini

  • OpenCode CLIMCP ana araç

    Terminal için açık kaynak kodlama ajanı

    id opencodebinary opencode

    önerilen modeller opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5

  • HermesMCP ana araç

    Nous Research’ün CLI ajanı

    id hermesbinary hermes

    önerilen modeller anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini

  • Kimi CodeMCP ana araç

    Moonshot AI’ın kodlama CLI’ı

    id kimibinary kimi

    önerilen modeller kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed

  • DeepSeek CLI

    DeepSeek’in kodlama CLI’ı

    id deepseekbinary deepseek

    önerilen modeller deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Minimal bir terminal kodlama çerçevesi

    id pibinary pi

    önerilen modeller sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeMCP ana araç

    Alibaba’nın CLI kodlama ajanı

    id qwenbinary qwen

    önerilen modeller qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    Terminalde yapay zekâ ile eşli programlama

    id aiderbinary aider

    önerilen modeller sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Google’ın açık kaynak terminal ajanı

    id geminibinary gemini

    önerilen modeller gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite

  • Cline CLI

    Özerk CLI kodlama ajanı

    id clinebinary cline

    önerilen modeller anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro

  • Crush

    Charm’ın terminal için kodlama ajanı

    id crushbinary crush

    önerilen modeller CLI'nin içinde seçilir

  • Goose

    Genel amaçlı açık kaynak yapay zekâ ajanı

    id goosebinary goose

    önerilen modeller claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro

  • Kilo Code

    CLI’lı açık kaynak kodlama ajanı

    id kilobinary kilo

    önerilen modeller kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest

  • Letta Code

    Uzun süreli belleği olan kodlama ajanı

    id lettabinary letta

    önerilen modeller zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct

  • Mistral Vibe

    Mistral’ın CLI kodlama ajanı

    id vibebinary vibe

    önerilen modeller CLI'nin içinde seçilir

  • Grok Build

    xAI’ın CLI kodlama ajanı

    id grokbinary grok

    önerilen modeller grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    AWS’in ajan tabanlı kodlama CLI’ı

    id kirobinary kiro-cli

    önerilen modeller claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6

  • Factory Droid

    Factory’nin CLI kodlama ajanı

    id droidbinary droid

    önerilen modeller CLI'nin içinde seçilir

  • Qoder CLI

    Qoder’ın ajan tabanlı kodlama CLI’ı

    id qoderbinary qodercli

    önerilen modeller auto, performance, lite

  • Warp

    Warp’un terminaldeki ajanı

    id warpbinary warp

    önerilen modeller CLI'nin içinde seçilir

  • Junie CLI

    JetBrains’in CLI kodlama ajanı

    id juniebinary junie

    önerilen modeller sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    GitHub’ın CLI kodlama ajanı

    id copilotbinary copilot

    önerilen modeller auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    Cursor’ın CLI kodlama ajanı

    id cursorbinary cursor-agent

    önerilen modeller gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    Atlassian’ın CLI kodlama ajanı

    id rovobinary acli

    önerilen modeller CLI'nin içinde seçilir

  • Claude Code ve Codex için akıl yürütme düzeyini --effort belirler. --auth-mode api-key Claude Code için geçerlidir.
  • Başka bir başlatma seçeneği gerekirse --extra-args ile geçirin, örneğin Claude Code'un --remote-control seçeneğini.
  • İzin istemlerini açık tutun. --skip, kodlama araçlarındaki izin istemlerini kapatır.

Ajan araçları

Bir ajanın kendi kabuğundan çalıştırabileceği dört yardımcı CLI. Sohbet görevi almazlar, bu yüzden başlatılabilir sağlayıcı değildirler. reevesagents tools bunları kurulum ve giriş durumlarıyla listeler.

  • Perplexity CLIpplx

    Perplexity’den web araması ve sayfa alıntıları, JSON olarak.

  • Google Colab CLIcolab

    Google Colab’da CPU, GPU ve TPU çalışma ortamları: betikleri ve not defterlerini uzaktan çalıştırır.

  • Hugging Face CLIhf

    Modelleri ve veri kümelerini indirir ve yükler, Hugging Face Hub’da işler çalıştırır.

  • Ollamaollama

    Yerel veya Ollama bulut modellerini terminalden çalıştırır.

Sorun giderme

İşe reevesagents doctor ile başlayın. Sorunun adını çoğu zaman o koyar.

tmux kurulu değil

brew install tmux ya da sudo apt install tmux ile kurun, sonra doctor komutunu yeniden çalıştırın.

Bir sağlayıcı görünmüyor

Genellikle CLI kurulu değildir ya da girişi yapılmamıştır. Bunu düzeltin, sonra reevesagents providers ile kontrol edin.

Web UI eksik paket olduğunu söylüyor

Canlı terminal, isteğe bağlı ws ve @lydell/node-pty modüllerine ihtiyaç duyar. Bunları geri getirmek için npm ya da pnpm ile global olarak yeniden kurun.

8080 portu dolu

Web UI sıradaki boş porta geçer ve URL'yi yazdırır. Portu kendiniz seçmek için reevesagents web --port 8090 kullanın.

WSL olmadan Windows

Ürünün tamamını WSL içinde çalıştırın. Yalnızca Agent Kontrolü gerekiyorsa reevesagents-win doğrudan Windows üzerinde bir MCP sunucusu olarak çalışır.

Kaynağından doğrulayın

İndirme dönemi: 2025-04-14 ile 2026-10-14. GitHub ve npm verileri 2026-10-15 tarihinde kontrol edildi. İndirmeler paket indirme isteklerini sayar.

Son güncelleme: