Hızlı başlangıç

Bu sayfa sizi kurulumdan yararlı bir ilk pi oturumuna götürür.

Pi bir npm paketi olarak dağıtılır:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

--ignore-scripts, kurulum sırasında bağımlılık yaşam döngüsü betiklerini devre dışı bırakır. Normal npm kurulumları için Pi kurulum betiklerine ihtiyaç duymaz.

pi'yi hangi paket yöneticisiyle kurduysanız kaldırmak için onu kullanın. curl kurulum aracı npm'i global olarak kullandığından, curl ve npm kurulumları npm ile kaldırılır:

# curl installer or npm install -g
npm uninstall -g @earendil-works/pi-coding-agent

# pnpm
pnpm remove -g @earendil-works/pi-coding-agent

# Yarn
yarn global remove @earendil-works/pi-coding-agent

# Bun
bun uninstall -g @earendil-works/pi-coding-agent

pi kaldırıldığında ayarlar, kimlik bilgileri, oturumlar ve kurulu pi paketleri ~/.pi/agent/ içinde kalır.

Ardından pi'nin üzerinde çalışmasını istediğiniz proje dizininde pi'yi başlatın:

cd /path/to/project
pi

Pi, /login üzerinden abonelik Provider'larını veya ortam değişkenleri ya da auth dosyası üzerinden API key Provider'larını kullanabilir.

pi'yi başlatın ve şunu çalıştırın:

/login

Ardından bir Provider seçin. Yerleşik abonelik girişleri Claude Pro/Max, ChatGPT Plus/Pro (Codex) ve GitHub Copilot içerir.

pi'yi başlatmadan önce bir API key ayarlayın:

export ANTHROPIC_API_KEY=sk-ant-...
pi

Ayrıca /login çalıştırıp bir API-key Provider seçerek key'i ~/.pi/agent/auth.json içinde saklayabilirsiniz.

Desteklenen tüm Provider'lar, ortam değişkenleri ve cloud provider kurulumu için Providers bölümüne bakın.

pi başladıktan sonra bir istek yazın ve Enter'a basın:

Summarize this repository and tell me how to run its checks.

Varsayılan olarak pi modele dört araç sağlar:

• read - dosyaları oku
• write - dosya oluştur veya üzerine yaz
• edit - dosyaları patch ile değiştir
• bash - Shell komutları çalıştır

Ek yerleşik read-only araçlar (grep, find, ls) araç seçenekleriyle kullanılabilir. Pi geçerli çalışma dizininizde çalışır ve oradaki dosyaları değiştirebilir. Kolayca geri dönebilmek istiyorsanız Git veya başka bir checkpoint workflow kullanın.

Pi başlangıçta context files yükler. Bir projede nasıl çalışması gerektiğini belirtmek için AGENTS.md dosyası ekleyin:

# Project Instructions

- Run `npm run check` after code changes.
- Do not run production migrations locally.
- Keep responses concise.

Pi şunları yükler:

• global talimatlar için ~/.pi/agent/AGENTS.md
• üst dizinlerden ve geçerli dizinden AGENTS.md veya CLAUDE.md

Bir dizin AGENTS.override.md içeriyorsa Pi, o dizindeki AGENTS.md veya CLAUDE.md yerine onu yükler.

context files değiştikten sonra pi'yi yeniden başlatın veya /reload çalıştırın.

Dosyaları fuzzy search ile bulmak için düzenleyicide @ yazın veya dosyaları komut satırında geçin:

pi @README.md "Summarize this"
pi @src/app.ts @src/app.test.ts "Review these together"

Görseller veya metin Ctrl+V ile yapıştırılabilir (Windows'ta Alt+V); görseller desteklenen terminallere sürüklenebilir.

Etkileşimli modda:

!npm run lint

Komut çıktısı modele gönderilir. Çıktıyı model bağlamına eklemeden komut çalıştırmak için !!command kullanın.

Model seçmek için /model veya Ctrl+L kullanın. thinking level değiştirmek için Shift+Tab kullanın. scoped models arasında dolaşmak için Ctrl+P / Shift+Ctrl+P kullanın.

Oturumlar otomatik olarak kaydedilir:

pi -c                  # Continue most recent session
pi -r                  # Browse previous sessions
pi --name "my task"    # Set session display name at startup
pi --session <path|id> # Open a specific session

pi içinde oturumları yönetmek için /resume, /new, /tree, /fork ve /clone kullanın.

Tek seferlik Prompt'lar için:

pi -p "Summarize this codebase"
cat README.md | pi -p "Summarize this text"
pi -p @screenshot.png "What's in this image?"

JSON event output için --mode json, süreç entegrasyonu için --mode rpc kullanın.

• Using Pi - etkileşimli mod, slash commands, oturumlar, context files ve CLI referansı.
• Providers - kimlik doğrulama ve model kurulumu.
• Settings - global ve proje yapılandırması.
• Keybindings - kısayollar ve özelleştirme.
• Pi Packages - paylaşılan Extensions, Skills, Prompts ve Themes yükleme.

Platform notları: Windows, Termux, tmux, Terminal setup, Shell aliases.