Termux (안드로이드) 설정

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 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. Termux (GitHub 또는 F-Droid에서)
2. Termux:API (GitHub 또는 F-Droid에서)

그런 다음 CLI 도구를 설치합니다.

pkg install termux-api

한 번 실행하여 스토리지 권한을 부여합니다.

termux-setup-storage

npm가 실패하면 캐시를 지워보세요.

npm cache clean --force