Configuración de Termux (Android)

Pi se ejecuta en Android mediante Termux, un emulador de terminal y entorno Linux para Android.

Requisitos previos

1. Instala Termux desde GitHub o F-Droid (no Google Play, esa versión está obsoleta)
2. Instala Termux:API desde GitHub o F-Droid para portapapeles e otras integraciones del dispositivo

Instalación

# 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

Soporte de portapapeles

Las operaciones de portapapeles usan termux-clipboard-set y termux-clipboard-get al ejecutarse en Termux. La app Termux:API debe estar instalada para que funcionen.

El portapapeles de imágenes no está soportado en Termux (la función de pegar imagen con ctrl+v no funcionará).

Ejemplo AGENTS.md para Termux

Crea ~/.pi/agent/AGENTS.md para ayudar al agente a entender el entorno 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

Limitaciones

• Sin portapapeles de imágenes: la API de portapapeles de Termux solo admite texto
• Sin binarios nativos: algunas dependencias nativas opcionales (como el módulo de portapapeles) no están disponibles en Android ARM64 y se omiten durante la instalación
• Acceso al almacenamiento: para acceder a archivos en /storage/emulated/0 (Downloads, etc.), ejecuta termux-setup-storage una vez para conceder permisos

Solución de problemas

El portapapeles no funciona

Asegúrate de que ambas apps estén instaladas:

1. Termux (desde GitHub o F-Droid)
2. Termux:API (desde GitHub o F-Droid)

Luego instala las herramientas CLI:

pkg install termux-api

Permiso denegado para almacenamiento compartido

Ejecuta una vez para conceder permisos de almacenamiento:

termux-setup-storage

Problemas de instalación de Node.js

Si npm falla, prueba limpiar la caché:

npm cache clean --force