Termux (Android) Setup

Pi läuft auf Android über Termux, einen Terminalemulator und eine Linux-Umgebung für Android.

1. Installieren Sie Termux von GitHub oder F-Droid (nicht Google Play, diese Version ist veraltet)
2. Installieren Sie Termux:API von GitHub oder F-Droid für die Zwischenablage und andere Geräteintegrationen

# 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

Zwischenablageoperationen verwenden termux-clipboard-set und termux-clipboard-get, wenn sie in Termux ausgeführt werden. Damit diese funktionieren, muss die App Termux:API installiert sein.

Die Bildzwischenablage wird auf Termux nicht unterstützt (die Funktion zum Einfügen von Bildern in ctrl+v funktioniert nicht).

Erstellen Sie ~/.pi/agent/AGENTS.md, um dem Agenten zu helfen, die Termux-Umgebung zu verstehen:

# 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 # Öffnet mit der Standard-App
termux-open --chooser image.jpg # App auswählen
```

## Clipboard
```bash
termux-clipboard-set "text" # Kopieren
termux-clipboard-get # Einfügen
```

## Notifications
```bash
termux-notification -t „Titel“ -c „Inhalt“
```

## Device Info
```bash
termux-battery-status # Batterieinfo
termux-wifi-connectioninfo # WLAN-Info
termux-telephony-deviceinfo # Geräteinfo
```

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

## Other Useful Commands
```bash
termux-toast „message“ # Schnelles Toast-Popup
termux-vibrate # Gerät vibrieren
termux-tts-speak „hello“ # Text in Sprache
termux-camera-photo out.jpg # Foto aufnehmen
```

## 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

• Keine Bild-Zwischenablage: Termux Zwischenablage API unterstützt nur Text
• Keine nativen Binärdateien: Einige optionale native Abhängigkeiten (wie das Zwischenablagemodul) sind auf Android ARM64 nicht verfügbar und werden während der Installation übersprungen
• Speicherzugriff: Um auf Dateien in /storage/emulated/0 (Downloads usw.) zuzugreifen, führen Sie termux-setup-storage einmal aus, um Berechtigungen zu erteilen

Stellen Sie sicher, dass beide Apps installiert sind:

1. Termux (von GitHub oder F-Droid)
2. Termux:API (von GitHub oder F-Droid)

Anschließend installieren Sie die CLI Tools:

pkg install termux-api

Einmal ausführen, um Speicherberechtigungen zu erteilen:

termux-setup-storage

Wenn npm fehlschlägt, versuchen Sie, den Cache zu leeren:

npm cache clean --force