Thiết lập Termux (Android)

Pi chạy trên Android thông qua Termux, trình mô phỏng thiết bị đầu cuối và môi trường Linux dành cho Android.

1. Cài đặt Termux từ GitHub hoặc F-Droid (không phải Google Play, phiên bản đó không được dùng nữa)
2. Cài đặt Termux:API từ GitHub hoặc F-Droid cho clipboard và tích hợp thiết bị khác

# 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

Các thao tác trong bảng nhớ tạm sử dụng termux-clipboard-set và termux-clipboard-get khi chạy trong Termux. Ứng dụng Termux:API phải được cài đặt để ứng dụng này hoạt động.

Bảng nhớ tạm hình ảnh không được hỗ trợ trên Termux (tính năng dán hình ảnh ctrl+v sẽ không hoạt động).

Tạo ~/.pi/agent/AGENTS.md để giúp tổng đài viên hiểu được môi trường 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

• Không hỗ trợ bảng tạm hình ảnh: API bảng tạm của Termux chỉ hỗ trợ văn bản.
• Không có tệp nhị phân gốc: Một số phần phụ thuộc gốc tùy chọn, chẳng hạn mô-đun bảng tạm, không khả dụng trên Android ARM64 và bị bỏ qua khi cài đặt.
• Truy cập bộ nhớ: Để truy cập các tệp trong /storage/emulated/0 (Downloads, v.v.), hãy chạy termux-setup-storage một lần để cấp quyền.

Đảm bảo đã cài đặt cả hai ứng dụng:

1. Termux (từ GitHub hoặc F-Droid)
2. Termux:API (từ GitHub hoặc F-Droid)

Sau đó, cài đặt các công cụ CLI:

pkg install termux-api

Chạy một lần để cấp quyền lưu trữ:

termux-setup-storage

Nếu npm không thành công, hãy thử xóa bộ nhớ đệm:

npm cache clean --force