Configuração, personalização, ajustes de plataforma e referências de API para Pi.

Termux (Android) Configuração

Pi roda em Android via Termux, um emulador de terminal e ambiente Linux para Android.

Pré-requisitos

  1. Instale Termux de GitHub ou F-Droid (não do Google Play, essa versão está obsoleta)
  2. 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
pi

Suporte 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 # Abre com o aplicativo padrão
termux-open --chooser image.jpg # Escolha o aplicativo
```

## Clipboard
```bash
termux-clipboard-set "texto" # Copiar
termux-clipboard-get # Colar
```

## Notifications
```bash
termux-notification -t "Título" -c "Conteúdo"
```

## Device Info
```bash
termux-battery-status # Informações da bateria
termux-wifi-connectioninfo # Informações WiFi
termux-telephony-deviceinfo # Informações do dispositivo
```

## Sharing
```bash
termux-share -a enviar arquivo.txt # Compartilhar arquivo
```

## Other Useful Commands
```bash
termux-toast "mensagem" # Pop-up rápido do brinde
termux-vibrate # Vibra dispositivo
termux-tts-speak "olá" # Texto para fala
termux-camera-photo out.jpg # Tirar 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

Limitações

  • Sem área de transferência de imagem: Termux área de transferência API suporta apenas texto
  • Sem binários nativos: algumas dependências nativas opcionais (como o módulo da á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.), execute termux-setup-storage uma vez para conceder permissões

Solução de problemas

A área de transferência não funciona

Certifique-se de que ambos os aplicativos estejam instalados:

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

Em seguida, instale as ferramentas CLI:

pkg install termux-api

Permissão negada para armazenamento compartilhado

Execute uma vez para conceder permissões de armazenamento:

termux-setup-storage

Node.js problemas de instalação

Se npm falhar, tente limpar o cache:

npm cache clean --force