Termux（Android）セットアップ

Pi は Termux 経由で Android 上で動作します。Termux は Android 向けターミナルエミュレーターおよび Linux 環境です。

前提条件

GitHub または F-Droid から Termux をインストール（Google Play 版は非推奨のため使用しない）
クリップボードなどデバイス連携用に 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 による画像貼り付けは動作しません）。

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

制限

画像クリップボードなし：Termux クリップボード API はテキストのみ
ネイティブバイナリなし：一部のオプション native 依存（クリップボードモジュールなど）は Android ARM64 で利用不可で、インストール時にスキップされます
ストレージアクセス：/storage/emulated/0（Downloads など）のファイルにアクセスするには、一度 termux-setup-storage を実行して権限を付与

トラブルシューティング

クリップボードが動作しない

両方のアプリがインストールされていることを確認：

Termux（GitHub または F-Droid）
Termux:API（GitHub または F-Droid）

次に CLI ツールをインストール：

pkg install termux-api

共有ストレージで Permission denied

一度実行してストレージ権限を付与：

termux-setup-storage

Node.js インストールの問題

npm が失敗する場合、キャッシュをクリア：

npm cache clean --force