Termux (Android) Настройка
Pi работает на Android через Termux, эмулятор терминала и среду Linux для Android.
Предварительные условия
- Установите 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-clipboard-set и termux-clipboard-get при работе в Termux. Чтобы они работали, необходимо установить приложение Termux:API.
Буфер обмена изображений не поддерживается на Termux (функция вставки изображений ctrl+v не работает).
Пример AGENTS.md для Termux
Создайте ~/.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Ограничения
- Нет буфера обмена для изображений: API буфера обмена Termux поддерживает только текст.
- Нет нативных бинарных файлов: некоторые необязательные нативные зависимости, например модуль буфера обмена, недоступны на Android ARM64 и пропускаются при установке.
- Доступ к хранилищу: чтобы получить доступ к файлам в
/storage/emulated/0(Downloads и т. п.), один раз запуститеtermux-setup-storageдля выдачи разрешений.
Устранение неполадок
Буфер обмена не работает
Убедитесь, что установлены оба приложения:
- Termux (из GitHub или F-Droid)
- Termux:API (из GitHub или F-Droid)
Затем установите инструменты CLI:
pkg install termux-apiДоступ к общему хранилищу запрещен.
Запустите один раз, чтобы предоставить разрешения на хранение:
termux-setup-storageNode.js проблемы с установкой
Если npm не работает, попробуйте очистить кеш:
npm cache clean --force