Termux (Android) セットアップ

Pi は、Android 用のターミナル エミュレーターおよび Linux 環境である Termux を介して 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 画像貼り付け機能は機能しません)。

エージェントが Termux 環境を理解できるように、~/.pi/agent/AGENTS.md を作成します。

# 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 # デフォルトのアプリで開きます
termux-open --chooser image.jpg # アプリを選択
```

## Clipboard
```bash
termux-clipboard-set "text" # コピー
termux-clipboard-get # 貼り付け
```

## Notifications
```bash
termux-notification -t "タイトル" -c "内容"
```

## Device Info
```bash
termux-battery-status # バッテリー情報
termux-wifi-connectioninfo # WiFi 情報
termux-telephony-deviceinfo # デバイス情報
```

## Sharing
```bash
termux-share -a send file.txt # ファイルを共有
```

## Other Useful Commands
```bash
termux-toast "message" # クイックトーストポップアップ
termux-vibrate # デバイスを振動させる
termux-tts-speak "hello" # テキスト読み上げ
termux-camera-photo out.jpg # 写真を撮る
```

## 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 回実行して権限を付与します

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

1. Termux (GitHub または F-Droid から)
2. Termux:API (GitHub または F-Droid から)

次に、CLI ツールをインストールします。

pkg install termux-api

1 回実行してストレージ権限を付与します。

termux-setup-storage

npm が失敗した場合は、キャッシュをクリアしてみてください。

npm cache clean --force