Imported from camdoherty/codex-cli-voice-android (AGENTS.md). Install upstream with npx skills add camdoherty/codex-cli-voice-android. Copyright stays with the author.

Agent Notes

This repository is the public, sanitized build and deployment wrapper for Codex CLI + Voice on Android/Termux.

Rules

• Do not commit built artifacts such as .tar.gz, .apk, .metadata, or checksum files.
• Do not add private hostnames, LAN IPs, personal usernames, SSH key paths, auth files, or API keys to docs or scripts.
• Keep the upstream Codex version visible in README.md and build.sh.
• Prefer .env.example placeholders over real deployment values.
• Treat codex-voice as billable unless the realtime guard is active.
• Treat support/termux-skills/stts as the source mirror for the local Termux stts skill.
• Treat support/termux-skills/termux-agent-ops as the source mirror for the local Termux termux-agent-ops skill.
• Treat support/termux-skills/obsidian-notes-maintainer as the source mirror for the local Termux obsidian-notes-maintainer skill.
• Treat support/termux-agent-assets as opt-in/reference assets for device agent instructions and CCAT contract docs; do not auto-install them during package deploy.
• Keep experimental activation prototypes, private logs, personal profiles, and prototype routing assumptions out of the stable release.
• For dev workspace disk cleanup, follow docs/maintenance/DEV_REPO_CLEANUP.md. Preserve the active release family, the latest known-good previous build, codex-cargo-cache, and android-toolchain.
• A successful Bridge APK build is not a device deploy. When Android Bridge behavior changes, install the rebuilt APK on the target device, restart the Bridge foreground service, and verify 127.0.0.1:8765 from Termux before asking for user testing. See DEPLOY.md.

Validation

Before publishing changes, run:

bash -n build.sh scripts/*.sh
sh -n support/termux-skills/termux-agent-ops/scripts/*
python3 -m py_compile \
  scripts/smoke_text_voice_ws.py \
  scripts/autotest_text_voice_kokoro.py \
  scripts/autotest_termux_stts_skill.py \
  support/termux-skills/stts/scripts/stts_loop.py
rg -n 'replace-this-with-private-hostnames-or-paths|private-host|private-path|/home/[^/[:space:]]+|100\\.97\\.|192\\.168\\.'
find . -type f \( -name '*.tar.gz' -o -name '*.apk' -o -name '*.metadata' -o -name '*.pyc' \) -print

For full stts changes, follow support/termux-skills/stts/references/testing-process.md. That process documents cleanup/status preflight, raw STT calibration, full multi-turn testing, and acceptance criteria.