Termux (Android) Configuração
Pi roda em Android via Termux, um emulador de terminal e ambiente Linux para Android.
Pré-requisitos
- Instale Termux de GitHub ou F-Droid (não do Google Play, essa versão está obsoleta)
- Instale Termux:API de GitHub ou F-Droid para área de transferência e outras integrações de dispositivos
Instalação
# 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
piSuporte para área de transferência
As operações da área de transferência usam termux-clipboard-set e termux-clipboard-get quando executadas em Termux. O aplicativo Termux:API deve estar instalado para que funcionem.
A área de transferência de imagens não é suportada em Termux (o recurso de colagem de imagens ctrl+v não funcionará).
Exemplo AGENTS.md para Termux
Crie ~/.pi/agent/AGENTS.md para ajudar o agente a entender o ambiente 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` accessLimitações
- Sem área de transferência de imagens: a API da área de transferência do Termux só oferece suporte a texto.
- Sem binários nativos: algumas dependências nativas opcionais, como o módulo de área de transferência, não estão disponíveis no Android ARM64 e são ignoradas durante a instalação.
- Acesso ao armazenamento: para acessar arquivos em
/storage/emulated/0(Downloads etc.), executetermux-setup-storageuma vez para conceder permissões.
Solução de problemas
A área de transferência não funciona
Verifique se os dois aplicativos estão instalados:
- Termux (do GitHub ou F-Droid)
- Termux:API (do GitHub ou F-Droid)
Em seguida, instale as ferramentas de CLI:
pkg install termux-apiPermissão negada para armazenamento compartilhado
Execute uma vez para conceder permissões de armazenamento:
termux-setup-storageNode.js problemas de instalação
Se npm falhar, tente limpar o cache:
npm cache clean --force