Termux（Android）設定

Pi 透過Termux（適用於 Android 的終端機模擬器和 Linux 環境）在 Android 上執行。

1. 從 GitHub 或 F-Droid 安裝 Termux（不是 Google Play，該版本已棄用）
2. 從 GitHub 或 F-Droid 安裝 Termux:API 以進行剪貼簿和其他設備整合

# 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

在 Termux 中執行階段，剪貼簿操作使用 termux-clipboard-set 和 termux-clipboard-get。必須安裝 Termux:API 應用程式才能正常工作。

Termux 不支援圖片剪貼簿（ctrl+v 圖片貼上功能將不起作用）。

建立 ~/.pi/agent/AGENTS.md 來說明智能體瞭解 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

• 不支援圖片剪貼簿：Termux 剪貼簿 API 僅支援文字
• 沒有原生二進位檔：某些選用的原生相依項（例如剪貼簿模組）在 Android ARM64 上無法使用，並會在安裝期間略過
• 儲存空間存取：若要存取 /storage/emulated/0 中的檔案（下載項目等），請執行一次 termux-setup-storage 以授予權限

請確認已安裝這兩個應用程式：

1. Termux（來自 GitHub 或 F-Droid）
2. Termux:API（來自 GitHub 或 F-Droid）

然後安裝 CLI 工具：

pkg install termux-api

執行一次以授予儲存權限：

termux-setup-storage

如果 npm 失敗，請嘗試清除快取：

npm cache clean --force