Guides
rpath refreshes PATH for the shell you already have open. It builds an environment plan, diagnoses problems, and emits shell-specific commands that can be evaluated by a tiny wrapper.
Recommended path
- Install rpath.
- Run the quick start for your shell.
- Read Shell Wrappers before debugging a session that prints a plan but does not change PATH.
- Use PATH Planning to understand where entries come from.
- Use Troubleshooting when
doctor, profile loading, or integrations report warnings.
What rpath manages
| Area | What to read |
|---|---|
| Setup | Installation, Quick Start, Uninstall |
| Shell behavior | Shell Wrappers |
| Diagnostics and repair | PATH Planning, Troubleshooting |
| Rollback | Snapshots & Versions |
| Local tooling | Integrations |
| Automation | Command Reference, JSON Output |
Safety model
rpath does not modify system-wide environment variables when you refresh. It computes a plan and prints commands for the selected shell. Persistent writes happen only for explicit commands such as install, uninstall, upgrade, snapshot, watch --install-service, or integrate ... install.
Profile installers create backups before editing shell profile files. Emit mode refuses to print mutation commands when the plan contains hard errors.