# Termux / Android Support

Voxcode can run in Termux on Android devices with the proper Node.js environment.

## Setup

```bash
# Update packages
pkg update && pkg upgrade

# Install Node.js (>= 22.19.0 required)
pkg install nodejs-lts

# Verify
node -v
npm -v

# Install Voxcode
npm i -g @voxcode-dev/voxcode

# Start a session
vox
```

## Limitations

- **Performance** — mobile CPUs are slower; expect longer response times on large repositories
- **Display** — small screens truncate TUI output; use compact prompts
- **Keyboard** — software keyboards may not send function keys or modifier combos reliably
- **Persistence** — Android may kill background processes; use tmux inside Termux for session survival

## Recommendations

- Keep prompts concise for mobile workflows.
- Use one-shot mode (`vox -p "..."`) for quick tasks rather than interactive sessions.
- Install a physical keyboard or use Hacker's Keyboard for better keybinding support.
- Validate terminal color and keyboard behavior before starting complex work.
- Consider using a VPS or remote dev server with `vox` and connecting from Termux via SSH.

## Troubleshooting

- **Node.js not found**: run `pkg install nodejs-lts` again
- **npm global install fails**: ensure `$PREFIX/bin` is in your PATH
- **TUI rendering issues**: try `vox -p` (one-shot mode) as a fallback
