Codex PreToolUse hook for rewriting noisy Windows, PowerShell, and shell
commands into lower-token RTK commands.
The binary reads Codex hook JSON from stdin. For safe equivalent rewrites, it
lets Codex run the RTK-shaped command through updatedInput.command.
Unsupported, ambiguous, malformed, and mutating commands exit 0 with no output
so the hook fails open. Non-equivalent guidance may still deny with a visible
reason.
It is especially useful on Windows, where Codex sessions often need pasteable
PowerShell commands, %LOCALAPPDATA% installs, and conservative rewrites that
avoid mutating or shell-sensitive commands.
Ask Codex:
Install rtk-codex-hook from https://github.com/LK4D4/rtk-codex-hook on this machine.
Codex can install from the GitHub release without a local repo checkout. On
Windows, it installs the release binary under %LOCALAPPDATA%\rtk-codex-hook
and registers the hook in Codex config.
Agent-facing install steps live in CODEX_INSTALL.md.
rtk-codex-hook reads Codex PreToolUse JSON from stdin and stays quiet unless
it can safely rewrite or explicitly guide a command. Ambiguous, unsupported,
malformed, or mutating commands fail open with no output.
Repo-tested Codex usage guidance lives in RTK.md.
Developer docs, release steps, debugging, and full rewrite details live in
docs/DEVELOPMENT.md.