| name | token-saver |
| description | Use TokTrans when a user wants Codex CLI prompts translated through a translation adapter, or wants to install, configure, diagnose, or uninstall the codex-ts wrapper. |
TokTrans
TokTrans provides a local wrapper command, codex-ts, that keeps the official codex installation untouched.
Use it when:
- The user wants prompts in any natural language translated to English before Codex CLI receives them.
- The user wants final Codex answers translated back to their original language.
- The user asks to diagnose or safely uninstall the wrapper.
Important behavior:
codex-ts exec is the reliable path. It captures the final assistant message with --output-last-message, translates only that final message, and preserves the original exit code.
- Interactive TUI mode translates only the initial prompt and injects final-answer language guidance. Live streamed output filtering is best-effort until Codex exposes stable final-output hooks.
- If translation fails, the wrapper falls back to raw
codex.
- The installer never overwrites official Codex binaries or unmanaged user files.
Typical commands:
./scripts/install.sh
codex-ts doctor
codex-ts exec "请帮我检查这个仓库的测试失败原因"
codex-ts exec "Por favor revisa por que fallan las pruebas"
./scripts/uninstall.sh --dry-run