Configuration, personnalisation, paramètres de plateforme et références API pour Pi.

Configuration Termux (Android)

Pi fonctionne sur Android via Termux, un émulateur de terminal et un environnement Linux pour Android.

Conditions préalables

  1. Installez Termux depuis GitHub ou F-Droid (pas Google Play, cette version est obsolète)
  2. Installez Termux:API depuis GitHub ou F-Droid pour le presse-papiers et d'autres intégrations de périphériques

Installation

# 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

Prise en charge du presse-papiers

Les opérations du Presse-papiers utilisent termux-clipboard-set et termux-clipboard-get lorsqu'elles sont exécutées dans Termux. L'application Termux:API doit être installée pour que celles-ci fonctionnent.

Le presse-papiers d'images n'est pas pris en charge sur Termux (la fonction de collage d'image ctrl+v ne fonctionnera pas).

Exemple AGENTS.md pour Termux

Créez ~/.pi/agent/AGENTS.md pour aider l'agent à comprendre l'environnement Termux:

# 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

Limitations

  • Pas de presse-papiers d'images : l'API du presse-papiers de Termux ne prend en charge que le texte.
  • Pas de binaires natifs : certaines dépendances natives facultatives, comme le module de presse-papiers, ne sont pas disponibles sur Android ARM64 et sont ignorées pendant l'installation.
  • Accès au stockage : pour accéder aux fichiers dans /storage/emulated/0 (Téléchargements, etc.), exécutez une fois termux-setup-storage afin d'accorder les autorisations.

Dépannage

Le presse-papiers ne fonctionne pas

Assurez-vous que les deux applications sont installées :

  1. Termux (depuis GitHub ou F-Droid)
  2. Termux:API (depuis GitHub ou F-Droid)

Installez ensuite les outils CLI :

pkg install termux-api

Autorisation refusée pour le stockage partagé

Exécutez une fois pour accorder les autorisations de stockage:

termux-setup-storage

Node.js problèmes d'installation

Si npm échoue, essayez de vider le cache:

npm cache clean --force