Termux (Android) 设置

Pi 通过 Termux在 Android 上运行，Termux 是一个适用于 Android 的终端模拟器和 Linux 环境。

前提条件

安装 Termux （从 GitHub 或 F-Droid 安装，不要从 Google Play 安装，该版本已弃用）
安装 Termux:API （从 GitHub 或 F-Droid 安装，用于剪贴板和其他设备集成）

安装

# 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 图像粘贴功能将无法使用）。

Termux 的 AGENTS.md 示例

创建 ~/.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