claude-code-termux/docs/02-base-packages.md

# 02 — Base packages

Minimum set of packages needed by Claude Code and the helper scripts in this repo. Everything here is idempotent — re-running is safe.

## Required (Claude Code itself)

```bash
pkg install -y \
    nodejs \
    python \
    git \
    proot \
    ripgrep
```

| Package | Why |
|---------|-----|
| `nodejs` | Claude Code runs on Node.js |
| `python` | Handy in general; also required by the mDNS companion repo |
| `git` | Cloning this repo, version control inside Claude |
| `proot` | Provides `termux-chroot` used by `clauded` (fixes `/tmp`) |
| `ripgrep` | Faster search inside Claude (the bundled one may not run on aarch64) |

## Recommended (SSH)

```bash
pkg install -y openssh termux-api
```

| Package | Why |
|---------|-----|
| `openssh` | SSH server (`sshd`) and client |
| `termux-api` | Backs the `termux-*` Android-bridge commands |

For `.local` / Tailscale hostname resolution install the companion repo
[**mdns-termux**](https://devops.ingeniumcodex.com/andresgarcia0313/mdns-termux)
(it handles its own `pip install zeroconf`).

## Optional (file sharing)

```bash
pkg install -y samba
```

See `03-samba.md` for the rest of the setup (custom port 4450, share definitions).

## Optional (image support in Claude)

```bash
npm install -g @img/sharp-wasm32 sharp --force
```

Enables image input (screenshots, diagrams). Sometimes flaky on aarch64; safe to skip.

## Verifying

```bash
node --version       # >= 22 LTS recommended
python --version     # 3.11+
proot --version
ssh -V
```

If any of these fail, re-run the relevant `pkg install`.

## What's next

`03-samba.md` — expose Termux storage as an SMB share (optional).

`04-claude-code.md` — Claude Code specifics on Termux.

For SSH/mDNS host resolution follow the standalone repo
[**mdns-termux**](https://devops.ingeniumcodex.com/andresgarcia0313/mdns-termux).