/ guides

Guides

Practical how-tos: installation, customization, troubleshooting, and migration.

Installation

Requires a working Termux on aarch64, arm64, amd64 or i686. The installer uses only bash and standard Termux tools:

bash <(curl -fsSL https://raw.githubusercontent.com/Vaizer0/zero-termux/main/install.sh)

What it does, step by step:

Verifies and installs dependencies: tput git glow gh rg jq bat curl.
Creates the Zero-Termux directories under $HOME / $PREFIX.
Clones this repository (or pulls updates on re-run).
Symlinks the zero command into $PREFIX/bin/zero.
Adds the signed APT repository (sources list + GPG key) and runs apt update.
Saves the configuration (zero_data, zero_cache, zero_config, zero_source, zero_tool_data).
Prints a summary with next steps.

Offline check The installer needs network access to GitHub and the GPG-signed repo. If apt update fails, verify connectivity; the repo is served from GitHub Pages.

Customization

Which tools: install per-tool with zero install <module> --<tool> instead of whole categories.
Environment variables: zero env set KEY value / zero env unset KEY / zero env ls.
Shell: the shell module sets up ZSH with Oh My Zsh, powerlevel10k and plugins.
UI: ui module: fonts, cursor, extra keys, welcome banner.
Memories: zero brain init then zero brain save / zero brain search.

Updating

What	Command
Framework	`zero update zero` (git pull; the installer also updates)
One module	`zero update <module> [--tool …]`
APT packages	`apt update && pkg upgrade`

Troubleshooting

Symptom	Fix
`zero: command not found`	Check the symlink: `ls -l $PREFIX/bin/zero`; re-run the installer.
`curl: command not found`	`pkg install curl` first.
`apt update` fails on the repo	Connectivity to vaizer0.github.io; re-check the sources line and key file.
Whole-module install is slow	Expected for `ai` (1–2 h). Install per-tool instead.
Tool version looks stale	Rolling tools resolve latest at install time; `zero update <module>` re-resolves.
GPG verify fails	Re-download the public key from `https://vaizer0.github.io/zero-termux/zero-termux.gpg`; fingerprint `DF2C7FCD…C494`.
Broken tool install	`zero reinstall <module> --<tool>`.

Migration from an earlier setup

Zero-Termux keeps its own layout and does not overwrite an existing ~/.zshrc, npm global prefix, or project configs — the shell module appends its own setup rather than replacing yours. Notes:

Framework data: $HOME/.local/share/zero-termux (data), $HOME/.cache/zero-termux (cache), config under ~/.config/zero-termux.
Binary entry point: $PREFIX/bin/zero (symlink — remove it to uninstall the CLI).
APT: the repo is added under $PREFIX/etc/apt/sources.list.d/zero-termux.list; removing that file + the key disables it.
Packages remove cleanly with pkg remove <name>; the CLI ecosystem with zero uninstall <module>.