App shims

App shims make normal commands such as claude and codex run under Rye supervision without changing developer workflow.

Install shims

rye app wrap claude codex

The installer runs this automatically with --skip-missing unless you pass --no-wrap-agents. Shims are written to:

~/.rye/shims

Each shim calls Rye’s internal shim entrypoint and passes the original arguments through to the real app.

For zsh or bash:

export PATH="$HOME/.rye/shims:$PATH"

For fish:

fish_add_path -p "$HOME/.rye/shims"

Restart the shell after changing PATH. The shims directory must appear before the real claude or codex binary directories.

rye app list
rye app doctor

rye app doctor checks:

rye app unwrap claude codex

This removes the shim files and clears the app shim configuration.

If you do not want the installer to set up shims:

curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- --no-wrap-agents

You can enable shims later:

rye app wrap claude codex

Use	Command
One supervised session	`rye wrap claude`
Every future shell invocation	`rye app wrap claude`
Inspect shim setup	`rye app doctor`
Disable automatic wrapping	`rye app unwrap claude`