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
- Instale Termux desde GitHub o F-Droid (no en Google Play, esa versión está obsoleta)
- 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
piSoporte 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` accessLimitaciones
- 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.), ejecutetermux-setup-storageuna vez para otorgar permisos
Solución de problemas
Portapapeles no funciona
Asegúrese de que ambas aplicaciones estén instaladas:
- Termux (de GitHub o F-Droid)
- Termux:API (de GitHub o F-Droid)
Luego instale las herramientas CLI:
pkg install termux-apiPermiso denegado para almacenamiento compartido
Ejecute una vez para otorgar permisos de almacenamiento:
termux-setup-storageNode.js problemas de instalación
Si npm falla, intente borrar el caché:
npm cache clean --force