Configuración, personalización, ajustes de plataforma y referencias de API para Pi.

Termux (Android) Configuración

Pi se ejecuta en Android a través de Termux, un emulador de terminal y entorno Linux para Android.

Requisitos previos

  1. Instale Termux desde GitHub o F-Droid (no en Google Play, esa versión está obsoleta)
  2. Instale Termux:API desde GitHub o F-Droid para integraciones con el portapapeles y otros dispositivos

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 para portapapeles

Las operaciones del portapapeles utilizan termux-clipboard-set y termux-clipboard-get cuando se ejecutan en Termux. La aplicación Termux:API debe estar instalada para que funcionen.

El portapapeles de imágenes no es compatible con Termux (la función de pegado de imágenes ctrl+v no funcionará).

Ejemplo AGENTES.md para Termux

Cree ~/.pi/agent/AGENTS.md para ayudar al agente a comprender 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://ejemplo.com"
```

## Opening Files
```bash
termux-open file.pdf # Se abre con la aplicación predeterminada
termux-open --chooser image.jpg # Elige aplicación
```

## Clipboard
```bash
termux-portapapeles-set "texto" # Copiar
termux-portapapeles-get # Pegar
```

## Notifications
```bash
termux-notificación -t "Título" -c "Contenido"
```

## Device Info
```bash
termux-battery-status # Información de la batería
termux-wifi-connectioninfo # Información WiFi
termux-telephony-deviceinfo # Información del dispositivo
```

## Sharing
```bash
termux-share -a enviar archivo.txt # Compartir archivo
```

## Other Useful Commands
```bash
termux-toast "mensaje" # Ventana emergente de brindis rápido
termux-vibrate # Dispositivo de vibración
termux-tts-speak "hola" # Texto a voz
termux-camera-photo out.jpg # Tomar foto
```

## 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: Termux portapapeles API solo admite texto
  • Sin archivos binarios nativos: algunas dependencias nativas opcionales (como el módulo del portapapeles) no están disponibles en Android ARM64 y se omiten durante la instalación.
  • Acceso al almacenamiento: para acceder a los archivos en /storage/emulated/0 (Descargas, etc.), ejecute termux-setup-storage una vez para otorgar permisos

Solución de problemas

Portapapeles no funciona

Asegúrese de que ambas aplicaciones estén instaladas:

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

Luego instale las herramientas CLI:

pkg install termux-api

Permiso denegado para almacenamiento compartido

Ejecute una vez para otorgar permisos de almacenamiento:

termux-setup-storage

Node.js problemas de instalación

Si npm falla, intente borrar el caché:

npm cache clean --force