Pi için yapılandırma, özelleştirme, platform kurulumu ve API referansları.

Termux (Android) Kurulumu

Pi, Android için bir terminal emülatörü ve Linux ortamı olan Termux aracılığıyla Android'de çalışır.

Önkoşullar

  1. Termux'ı GitHub veya F-Droid'den yükleyin (Google Play değil, bu sürüm kullanımdan kaldırılmıştır)
  2. Pano ve diğer cihaz entegrasyonları için GitHub veya F-Droid'den Termux:API yükleyin

Kurulum

# Update packages
pkg update && pkg upgrade

# Install dependencies
pkg install nodejs termux-api git

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

# Create config directory
mkdir -p ~/.pi/agent

# Run pi
pi

Pano Desteği

Pano işlemleri Termux'de çalışırken termux-clipboard-set ve termux-clipboard-get'yi kullanır. Bunların çalışması için Termux:API uygulamasının yüklenmesi gerekir.

Resim panosu Termux'de desteklenmemektedir (ctrl+v resim yapıştırma özelliği çalışmayacaktır).

Termux için örnek AGENTS.md

Aracının Termux ortamını anlamasına yardımcı olmak için ~/.pi/agent/AGENTS.md oluşturun:

# Agent Environment: Termux on Android

## Location
- **OS**: Android (Termux terminal emulator)
- **Home**: `/data/data/com.termux/files/home`
- **Prefix**: `/data/data/com.termux/files/usr`
- **Shared storage**: `/storage/emulated/0` (Downloads, Documents, etc.)

## Opening URLs
```bash
termux-open-url "https://example.com"
```

## Opening Files
```bash
termux-open file.pdf          # Opens with default app
termux-open --chooser image.jpg      # Choose app
```

## Clipboard
```bash
termux-clipboard-set "text"   # Copy
termux-clipboard-get          # Paste
```

## Notifications
```bash
termux-notification -t "Title" -c "Content"
```

## Device Info
```bash
termux-battery-status         # Battery info
termux-wifi-connectioninfo    # WiFi info
termux-telephony-deviceinfo   # Device info
```

## Sharing
```bash
termux-share -a send file.txt # Share file
```

## Other Useful Commands
```bash
termux-toast "message"        # Quick toast popup
termux-vibrate                # Vibrate device
termux-tts-speak "hello"      # Text to speech
termux-camera-photo out.jpg   # Take photo
```

## Notes
- Termux:API app must be installed for `termux-*` commands
- Use `pkg install termux-api` for the command-line tools
- Storage permission needed for `/storage/emulated/0` access

Sınırlamalar

  • Görüntü panosu yok: Termux pano API'si yalnızca metni destekler.
  • Yerel ikili dosya yok: Pano modülü gibi bazı isteğe bağlı yerel bağımlılıklar Android ARM64'te kullanılamaz ve kurulum sırasında atlanır.
  • Depolama erişimi: /storage/emulated/0 içindeki dosyalara (Downloads vb.) erişmek için izin vermek üzere termux-setup-storage komutunu bir kez çalıştırın.

Sorun giderme

Pano çalışmıyor

Her iki uygulamanın da yüklü olduğundan emin olun:

  1. Termux (GitHub veya F-Droid'den)
  2. Termux:API (GitHub veya F-Droid'den)

Ardından CLI araçlarını yükleyin:

pkg install termux-api

Paylaşılan depolama için izin reddedildi

Depolama izinlerini vermek için bir kez çalıştırın:

termux-setup-storage

Node.js kurulum sorunları

npm başarısız olursa önbelleği temizlemeyi deneyin:

npm cache clean --force