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)

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)

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 (it handles its own pip install zeroconf).

pkg install -y samba

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

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

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

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

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

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.