Pi coding agent nedir? Kurulum, MCP, eklentiler, hangi modellerle çalışır ve ücretsiz mi

Proje klasöründe pi yazar, düz dille iş verirsin; Pi dosyaları okur, düzenler, komut çalıştırır ve yaptığı her adımı ekranda gösterir. Earendil Inc.'in açık kaynak (MIT) terminal kodlama ajanı; kendi modeli yok: /login komutuyla bir sağlayıcının API anahtarını (Claude için Anthropic Console anahtarı), ChatGPT ya da GitHub Copilot girişini ya da yerel bir modeli bağlarsın. Anthropic'in kuralı Claude aboneliğinin üçüncü taraf uygulamalarda kullanılmasına izin vermiyor. Yazılım ücretsiz; model ücreti bağladığın sağlayıcıya gider. 1 Ekim 2026'da çıkan 1.0 sürümüyle MCP desteği yerleşik geldi; eklenti, skill ve paketlerle genişletilir. Arayüz İngilizce, Türkçe yanıt seçtiğin modele bağlı.

Ne yapar: Her adımı gösteren açık kaynak terminal kodlama ajanı
Tür: Terminal kodlama ajanı, açık kaynak
Model: Kendi modeli yok; API anahtarı, giriş ya da yerel model
Nerede: macOS, Linux, Windows (terminal)
Onay: Her araç çağrısından önce sormaz
Son sürüm: 1.4.0 (21.10.2026)
Ücret: Yazılım ücretsiz (MIT); model ücreti ayrı

Pi nedir, ne işe yarar?

Bir yazılım projesinde tekrar eden işleri (dosya düzenleme, hata ayıklama, komut çalıştırma, depo hakkında soru) bir yapay zekâ ajanına yaptırmak istiyorsun ama hangi modeli kullanacağını ve ajanın nasıl çalışacağını sen belirlemek istiyorsun. Pi bunun için yapılmış bir ajan çatısı (harness): modeli çalıştıran, ona dosya okuma, düzenleme ve komut çalıştırma araçlarını veren ve konuşmayı yöneten program. Resmî tanımı "minimal, genişletilebilir, kendine göre uyarlayabileceğin bir ajan çatısı".

Düz dille kod ve dosya işi yaptırmakNe alırsın: Dosya değişiklikleri ve komut çıktısı; her adım ekranda görünürAyrı kurulum gerekir Modeli sen seç: anahtar, giriş ya da yerelNe alırsın: Seçili model; /model ile değişirBağlantı gerekir MCP sunucusu bağlamakNe alırsın: Sunucunun araçları ajandaAyrı kurulum gerekir

Klasörde pi yazarsınÇalışacağı proje klasöründe başlatırsın; dosyaları ve talimat dosyalarını oradan bulur.

İşi düz dille yazarsınDosyayı @ ile anarsın, ! ile komut çalıştırırsın.

Her adımı görürsünOkuduğu dosyayı, aramayı, komutu ve düzenlemeyi ekranda gösterir; çalışırken yön değiştirebilirsin.

Pi her araç çağrısından önce onay istemez; önemli işte sürüm kontrolü ya da yedek kullan.

Pi bilerek küçük tutuluyor: alt ajan, plan modu, izin pencereleri ve yapılacaklar listesi yerleşik değil. Bunlara ihtiyacın varsa bir eklenti kurarsın ya da Pi'den eklentiyi yazmasını istersin. Kime yarar: terminalde çalışmaya alışkın, modelini ve sağlayıcısını kendisi seçmek isteyen geliştiricilere ve ajanı kendi iş akışına göre uyarlamak isteyen ekiplere. Kime yaramaz: terminal kullanmayan ve onay pencereleriyle adım adım ilerleyen bir ajan isteyen kişiye.

Kaynaklar: pi.dev ana sayfası ("What we didn't build"), README, Quickstart (29.10.2026).

Pi nasıl kurulur? macOS, Linux, Windows

Hesap açman gerekmez; Pi'yi kurup bir model sağlayıcısına bağlarsın. Komutlar resmî README ve Quickstart'tan aynen alındı. Resmî yükleyici bütün bağımlılıkları sabit sürüme kilitler ve gerekirse Node.js'i de kurar; npm yolu ise Node.js 22.19 ya da yenisini ister ve alt bağımlılıkları kilitlemez.

Resmî yükleyici› curl -fsSL https://pi.dev/install.sh | sh

Sonradan güncellemek için pi update.

PowerShell› powershell -c "irm https://pi.dev/install.ps1 | iex"

Pi, komutları çalıştırmak için önce Git Bash'i arar; resmî belgeye göre çoğu Windows kullanıcısı için Git for Windows kurmak yeterli. Dosyaların Linux tarafındaysa Pi'yi WSL içinde çalıştırabilirsin.

Belirli sürümü kur› npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.4.0

README'deki komut sürüm yazmadan npm install -g --ignore-scripts @earendil-works/pi-coding-agent biçiminde; burada 29.10.2026'daki son sürüm (1.4.0, 21.10.2026) sabitlendi. Node.js 22.19 ya da yenisi gerekir. npm'deki kapsamsız pi-coding-agent adı yalnız bir ad rezervasyonu, gerçek paket değil.

Son kararlı sürüm› nix profile add github:earendil-works/pi/stable

Sürüm sabitlemek için github:earendil-works/pi/v1.0.0 gibi bir etiket kullanılır; Nix kurulumu pi update ile değil nix profile upgrade pi ile güncellenir.

Kurulduğunu doğrula: pi --version sürüm numarasını yazar.
Proje klasöründe başlat: cd ile klasöre gir ve pi yaz.
Modeli bağla: Pi içinde /login yaz, sağlayıcıyı seç; API anahtarını kaydet ya da sağlayıcının girişini kullan (Claude için Anthropic API anahtarı). Başka model için /model.

Kaynaklar: README, Quickstart, Windows Setup, npm kaydı (29.10.2026). Android için resmî belgede ayrı bir Termux kurulum sayfası var.

Pi nasıl kullanılır? Ne yazarsın, ne alırsın

Pi'ye iş verirken dosyayı @ ile anarsın (yazarken arama açılır), kısa bir komutun çıktısını konuşmaya eklemek için başına ! koyarsın. Aşağıdaki iki istek resmî Quickstart'taki örneklerden; sonuçlar belgenin anlattığı kadar tarif edildi.

Toplantı notundan yapılacaklar listesi"Summarize @meeting-notes.md and save the action items to action-items.md."Ne alırsın: Pi dosyayı okur, sohbete bir özet yazar ve yapılacakları yeni bir action-items.md dosyasına kaydeder. Okuma ve yazma adımları ekranda görünür; bittiğinde dosyayı açıp kontrol edersin. İsteği Türkçe de yazabilirsin; yanıt dili seçtiğin modele bağlı.

Bir depoyu tanımak"Explain how this repository is structured and how to run its checks."Ne alırsın: Pi klasörü tarar, ana klasörleri ve dosyaları açıklar, testlerin ya da denetimlerin hangi komutla çalıştığını anlatır. İstek yalnız açıklama istediği için beklenen çıktı bir anlatımdır; Pi'nin yaptığı her okuma ve düzenleme ekranda görünür.

İki tabloyu karşılaştırmak"Compare @previous.csv with @current.csv and summarize the important changes."Ne alırsın: iki CSV dosyası arasındaki önemli farkların yazılı özeti.

Komut çıktısını konuşmaya ekle› !git status

Çalışırken yön değiştirmek: Pi çalışırken Enter ile yazdığın mesaj, o anki yanıt ve araç çağrıları bitince bir sonraki yanıtı yönlendirir; Alt+Enter ise işi bitirmesini bekleyen bir sonraki istek olarak sıraya girer. Oturumlar: Pi her oturumu kaydeder; pi --continue son oturuma döner, /tree ile önceki bir mesaja gidip oradan dallanırsın. /export oturumu HTML ya da JSONL olarak yazar. /share oturumu yükler: Radius girişi varsa Radius kuruluşuna, yoksa GitHub CLI ile gizli bir gist'e; paylaşmadan önce oturumda anahtar ya da dosya içeriği olup olmadığına bak.

Betikten ve başka programlardan

Pi'nin dört çalışma biçimi var: tam ekran terminal arayüzü, betik için tek seferlik çıktı (print/JSON), başka dillerden kullanmak için RPC ve kendi uygulamana gömmek için TypeScript SDK.

Betikten tek seferlik görev, olaylar JSONL olarak› pi --mode json "Inspect this repository" > events.jsonl

Kaynaklar: Quickstart, Use Pi in the terminal, Sessions, Command Line belgeleri ve pi.dev (29.10.2026).

Pi hangi modellerle çalışır? Sağlayıcılar ve bağlanma yolları

Pi'nin kendi modeli yok. Sağlayıcı, Pi'nin modele ulaştığı hizmet ya da hesaptır; model yanıtları üreten yapay zekâdır. Resmî sayfa "15+ sağlayıcı, yüzlerce model" diyor; sağlayıcılar belgesindeki tablo bundan uzun. Güncel model listesi, bağlam sınırları ve fiyatlar resmî katalogda (pi.dev/models) duruyor; Pi açılışta bu katalogu güncelleyebilir.

Elindeki	Nasıl bağlanır	Resmî belgedeki örnekler
Sağlayıcı girişi	`/login` ile tarayıcıda giriş (OAuth)	OpenAI (Sign in with ChatGPT), GitHub Copilot; OpenRouter da girişle anahtar üretir. Pi belgesi Claude Pro/Max girişini de listeliyor, ama Anthropic'in kuralı Claude aboneliğinin üçüncü taraf uygulamalarda kullanılmasına izin vermiyor: Claude için API anahtarı satırını kullan
Bir API anahtarı	`/login` ile kaydet ya da ortam değişkeni	Anthropic, OpenAI, Google Gemini, Mistral, Groq, Cerebras, xAI, DeepSeek, OpenRouter, Hugging Face, Together AI, Fireworks, Meta, MiniMax, Kimi For Coding, NVIDIA NIM ve diğerleri
Bulut hesabı	Bulutun kendi kimlik bilgileri	Amazon Bedrock, Google Vertex AI, Azure OpenAI, Cloudflare Workers AI ve AI Gateway
Yerel model	llama.cpp yönlendiricisi ya da models.json	llama.cpp (doğrudan), Ollama, LM Studio, vLLM, SGLang

Hangisini seçmeli? Claude modellerini kullanacaksan Anthropic API anahtarı (Claude Console) ya da desteklenen bir bulut sağlayıcısı kullanırsın; kullandığın kadar ödersin. ChatGPT ya da Copilot girişini Pi belgesi sunuyor; bu girişi kullanmadan önce o sağlayıcının kullanım koşullarına bak. Başka bir sağlayıcıda da API anahtarını kaydedersin. Kodunun bilgisayarından çıkmasını istemiyorsan yerel bir model bağlarsın; hız ve kalite donanımına bağlıdır. Oturum içinde /model (ya da Ctrl+L) ile model değiştirirsin, /thinking ile seçili modelin düşünme düzeyini ayarlarsın, Ctrl+P favori modeller arasında dolaşır. Modeli değiştirdiğin an kullanım hakkı ve ücret de o sağlayıcının koşullarına geçer.

Ollama'yı bağlamak için ~/.pi/agent/models.json (resmî örnek)

› {
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434/v1",
      "api": "openai-completions",
      "apiKey": "ollama",
      "models": [{ "id": "qwen2.5-coder:7b" }]
    }
  }
}

Anthropic'in Claude Code hukuki belgesine göre Claude Free, Pro ve Max girişi Claude Code ve Anthropic'in kendi uygulamaları içindir; üçüncü taraf uygulamaların Claude.ai girişi sunmasına izin verilmez. Pi'de Claude modelleri için Anthropic API anahtarı (Claude Console) ya da desteklenen bir bulut sağlayıcısı kullan. ChatGPT ya da Copilot girişinde o sağlayıcının kullanım koşulları ve limitleri geçerlidir.

Kontrol tarihi: 29.10.2026. Kaynaklar: pi.dev, Providers, Choose a Model belgeleri ve pi-ai README'deki "OAuth Providers" listesi. Earendil'in kendi model geçidi Radius da bir sağlayıcı olarak eklenebiliyor; belge onu "erken alfa" diye anlatıyor ve fiyat vermiyor.

Pi MCP destekliyor mu? Eklenti, skill ve paket kurma

MCP (Model Context Protocol), yapay zekâya bir hizmeti ya da aracı (dosya sistemi, belge arama, veritabanı) kullandıran ortak bağlantı biçimidir. Pi eskiden MCP'yi bilerek dışarıda bırakıyordu; 1 Ekim 2026'daki 1.0 sürümüyle MCP desteği yerleşik geldi. Pi, yerel (stdio) ve uzak (streamable HTTP) sunuculara bağlanır; eski SSE taşıma biçimi desteklenmiyor.

Yerel bir MCP sunucusu ekle, kontrol et, başlat

› pi mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
pi mcp list
pi

Ne alırsın: Pi açıldığında bu sunucunun araçları (burada bulunduğun klasörde dosya işlemleri) kullanılabilir olur. Varsayılan codemode görünürlüğünde araçlar modele tek tek tanıtılmaz; model onları codemode betiğiyle arayıp çağırır. Sık kullandığın araçları doğrudan görünür yapmak için ayarda exposure: direct kullanılır. Komut sunucuyu kullanıcı düzeyinde ekler; yalnız bu projeye eklemek için --local kullanılır. Oturum içinde /mcp bağlantıları gösterir, sunucuyu açıp kapatır.

Neye ihtiyacın var	Pi'de karşılığı
Bir klasörde hep geçerli talimat	AGENTS.md dosyası
`/` menüsünden yeniden kullanılan istek	İstem şablonu (Markdown dosyası)
Belirli bir iş için talimat ve yardımcı dosyalar	Skill (SKILL.md klasörü; Agent Skills biçimi)
Yeni araç, komut ya da olay davranışı	Eklenti (TypeScript modülü)
Birkaçını birlikte paylaşmak	Pi paketi (npm ya da git)

npm'den sürüme sabit paket kurma (resmî örnek biçim)› pi install npm:@example/pi-tools@1.0.0

Pi'ye eklentiyi kendisine yazdırmak"Bana commit ve push işini tek komutta toplayan bir Pi eklentisi yaz; önce değişiklikleri göster, onaylarsam commit at."pi.dev'deki örnek tanıtım tam olarak bu tür bir iş akışı eklentisini Pi'ye yazdırıyor. Pi eklentiyi yazar; /reload ile yüklenir. Onay adımı Pi'de yerleşik değil, eklentinin içine yazılır.

Eklentiler ve paketler Pi ile aynı işletim sistemi izinleriyle çalışır; istemlerini, dosyalarını ve kimlik bilgilerini görebilir. Kaynağını okumadığın paketi kurma.

Kaynaklar: MCP Servers, Packages, Extensions, Skills belgeleri, Quickstart ("Choose how to customize Pi" tablosu), Pi 1.0 duyurusu (29.10.2026). Alt ajan ve plan modu yerleşik değil; pi.dev bunları eklentiyle, paketle ya da tmux ile ayrı Pi oturumları açarak yapmayı öneriyor.

Pi ücretsiz mi?

Evet, Pi yazılımı ücretsiz ve açık kaynak (MIT lisansı); Pi'nin kendi ücretli planı yok. Para, bağladığın modele gider: ChatGPT ya da Copilot girişini kullanırsan o planın ücreti ve limiti, API anahtarı kullanırsan sağlayıcının kullandıkça öde fiyatı, yerel modelde yalnız kendi donanımın. /session komutu oturumun jeton kullanımını ve maliyetini gösterir.

Yapabilirsin

Ticari kullanım dahil kullanmak, kopyalamak, değiştirmek ve dağıtmak (MIT)

Yasak

Telif ve lisans bildirimini kopyalardan çıkarmak
Yazılım "olduğu gibi" verilir; geliştirici garanti vermez

Kaynak: LICENSE (MIT, telif Mario Zechner), Pi 1.0 duyurusu ("Both are MIT licensed"), Use Pi in the terminal (29.10.2026). TL fiyat yok; ücret yalnız sağlayıcı tarafında. Bu bir hukuki görüş değildir.

Pi Türkçe çalışır mı?

ArayüzYok	Terminal arayüzü ve komutlar İngilizce.
Türkçe istek ve yanıtNet değil	İsteği Türkçe yazabilirsin; yanıtın dili ve kalitesi bağladığın modele bağlı. Resmî kaynak Türkçe'den söz etmiyor.
Türkçe belgeYok	Belgeler İngilizce.

Pi güvenli mi? Dosyalarıma ne yapar, verim nereye gider?

İzin sistemi yok

README: Pi'de dosya, işlem, ağ ya da kimlik bilgisi erişimini kısıtlayan yerleşik bir izin sistemi yok; onu başlatan kullanıcının izinleriyle çalışır ve her araç çağrısından önce sormaz. Belgenin önerisi: güvenmediğin ya da gözetimsiz işte Pi'yi bir konteyner ya da sanal makine içinde çalıştırmak.

Kodun nereye gider

Pi'nin okuduğu dosyalar ve istekler, bağladığın sağlayıcıya gider ve onun veri kuralları geçerlidir. Yerel model bağlarsan bilgisayarından çıkmaz.

Kimlik bilgileri

Giriş jetonları ve API anahtarları ~/.pi/agent/auth.json dosyasında durur; belge bu dosyayı gizli tutmanı ve depoya koymamanı söylüyor. Anahtarı diske yazmak istemezsen ortam değişkeni ya da şifre yöneticisi komutu kullanılabilir.

Telemetri

Kurulum ve güncelleme bildirimi varsayılan açık (anonim; ayar adı enableInstallTelemetry). PI_TELEMETRY=0 ile kapatılır. Analitik paylaşımı (enableAnalytics) varsayılan kapalı.

Proje güveni

Bir klasördeki .pi ayarları, MCP sunucuları ve eklentiler, sen o projeye güven verene kadar yüklenmez. Ama AGENTS.md ve CLAUDE.md gibi talimat dosyaları her durumda okunur; belge bunları güvenilmez girdi saymanı söylüyor.

Klasördeki dosyalar, yorumlar ve komut çıktıları modeli yönlendirebilir (istem enjeksiyonu). Bilmediğin bir depoda Pi'yi konteynerde çalıştır ve yalnız gereken dosya ve anahtarları ver.

Kaynaklar: README ("Permissions & Containerization"), Run Pi safely, Settings, Environment variables, Providers (29.10.2026). Bu bir güvenlik denetimi değildir; açık bildirimi deponun SECURITY.md yoluyla yapılır.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
`/model` listesinde istediğin model yok	Seçici yalnız giriş yapılmış sağlayıcıların modellerini gösterir. Önce `/login` ile o sağlayıcıyı bağla; katalogu tazelemek için `pi update --models`.
Windows'ta komutlar çalışmıyor	Pi komutlar için önce Git Bash'i arar. Git for Windows kur ya da Pi'yi WSL içinde çalıştır. Kontrol için Pi'de `!printf 'Bash is working\n'` yaz.
Projedeki .pi ayarları ya da MCP sunucuları yüklenmedi	Proje güveni verilmemiş. Pi açılışta sorar; kararını `/trust` ile kaydedebilirsin.
Uzak sunucuda `/login` tarayıcı dönüşü çalışmıyor	Belgeye göre istendiğinde son yönlendirme adresini ya da yetki kodunu Pi'ye yapıştırırsın.
MCP sunucusunu dışarıdan ekledim ama görünmüyor	Oturum içinde `/reload` çalıştır; durumu `/mcp` ile kontrol et.

Kaynaklar: Choose a Model, Windows Setup, Run Pi safely, Providers, MCP Servers (29.10.2026).

Pi nasıl kaldırılır?

› npm uninstall -g @earendil-works/pi-coding-agent

Yükleyiciyi yeniden çalıştır (curl -fsSL https://pi.dev/install.sh | sh) ve Uninstall Pi seçeneğini seç.

› nix profile remove pi

Bu yöntemlerin hiçbiri ~/.pi/agent/ klasörünü silmez: ayarlar, kayıtlı anahtar ve jetonlar (auth.json), oturumlar ve kurulu paketler orada kalır. Tamamen temizlemek istiyorsan bu klasörü kendin silersin; sağlayıcı girişinin yetkisini sağlayıcı tarafında ayrıca iptal edebilirsin (/logout sağlayıcıdaki yetkiyi geri almaz).

Pi mi, Claude Code mu, OpenCode mu?

Pi satırı bu sayfanın resmî kaynaklarından; diğer satırlar o araçların kendi rehberlerindeki özetlerdir. Bu bir sıralama değildir.

Sık sorulan sorular

Pi MCP destekliyor mu?

Evet. 1 Ekim 2026'daki 1.0 sürümünden beri MCP desteği yerleşik. Yerel ve uzak (streamable HTTP) sunucuları pi mcp add komutuyla eklersin; eski SSE biçimi desteklenmiyor.

Pi (pi.dev) nedir?

Earendil Inc.'in terminalde çalışan açık kaynak yapay zekâ kodlama ajanı. Proje klasöründe dosya okur, düzenler, komut çalıştırır; kendi modeli yok, sağlayıcıyı sen bağlarsın.

Pi mi Claude Code mu?

Pi açık kaynak ve sağlayıcıdan bağımsız: Claude aboneliğini de, başka bir sağlayıcıyı da, yerel modeli de bağlayabilirsin. Claude Code Anthropic'in kendi aracı ve Claude hesabıyla çalışır. Pi bilerek küçük tutuluyor; alt ajan ve plan modu gibi özellikler eklentiyle gelir.

Pi'ye eklenti ve skill nasıl kurulur?

Eklenti, skill, istem şablonu ve temalar paket olarak pi install komutuyla npm ya da git'ten kurulur. İstersen Pi'den eklentiyi kendisine yazmasını isteyip /reload ile yüklersin. Paketler Pi ile aynı izinlerle çalıştığı için kaynağını okumadan kurma.

Pi nasıl kurulur?

macOS ve Linux'ta curl -fsSL https://pi.dev/install.sh | sh, Windows'ta PowerShell yükleyicisi, ya da Node.js 22.19 ve üstüyle npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Sonra proje klasöründe pi yazıp /login ile model bağlarsın.

Pi Ollama ile çalışır mı?

Evet. Ollama, LM Studio, vLLM gibi uyumlu sunucular models.json dosyasına eklenir; llama.cpp ile doğrudan bağlantı da var. Model ücreti yok, hız donanımına bağlı.

Pi'de alt ajan (subagent) var mı?

Yerleşik değil. Resmî sayfa tmux ile ayrı Pi oturumları açmayı, bir eklenti yazmayı ya da bunu yapan bir paket kurmayı öneriyor.

Pi ücretsiz mi?

Yazılım ücretsiz ve MIT lisanslı; Pi'nin ücretli planı yok. Ücret bağladığın modele gider: ChatGPT ya da Copilot girişinde o planın ücreti, API anahtarında sağlayıcının fiyatı ya da yerel modelde yalnız donanımın.

İlgili rehberler

Cline

Cloudflare Workers AI

Kaynaklar

Resmî kaynaklarda net olmayanlar: Türkçe yanıt kalitesi (bağlanan modele bağlı; resmî kaynak Türkçe'den söz etmiyor) · Radius geçidinin fiyatı (erken alfa). Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.