| name | self-update |
| description | Update rp1 and run the full post-update lifecycle. |
| metadata | {"category":"knowledge","is_workflow":false,"version":"1.1.0","tags":["utility","update","maintenance"],"created":"2025-12-14T00:00:00.000Z","updated":"2026-02-26T00:00:00.000Z","author":"rp1"} |
Self-Update Command
Update rp1 using the unified lifecycle command. rp1 update now coordinates:
- CLI self-update
- plugin refresh for all detected tools using the latest installer logic
- project migrations when the current directory is an rp1 project
- Arcade daemon stop/restart when Arcade was already running
Execution
Run the following command via Bash:
rp1 update
Interpreting Results
CLI Update (rp1 update)
The CLI update command will output one of three outcomes:
Success (Exit Code 0)
The CLI update completed successfully. Example output:
Detecting installation method...
Homebrew installation detected
Updating rp1...
Successfully updated rp1 from 0.2.3 to 0.3.0
Report to user: Confirm the version change.
Manual Installation Required (Exit Code 2)
Automatic update is not available. Example output:
Detecting installation method...
Manual installation detected
Automatic update is not available for manual installations.
Please download the latest version from:
https://github.com/rp1-run/rp1/releases/latest
Report to user: Explain that they need to update the CLI manually and provide the GitHub releases link. rp1 update may still refresh plugins and run migrations with the currently installed binary, but the CLI binary itself still requires manual replacement.
Error (Exit Code 1)
The CLI update failed. Example output:
Error: brew upgrade failed: Permission denied
Report to user: Show the error message and suggest checking permissions or trying manual update.
Unified Lifecycle (rp1 update)
After the binary step, the same command continues by:
- Refreshing plugins for all detected agentic tools
- Running project migrations when applicable
- Restoring the Arcade daemon if it was running before update
Example output:
Detecting installed tools...
Found: Claude Code, OpenCode
Updating plugins for Claude Code...
Successfully updated plugins for Claude Code
Updating plugins for OpenCode...
Successfully updated plugins for OpenCode
Report to user: Confirm which tools were refreshed and whether migrations ran.
Restart Reminder
After reporting the results, always remind the user:
Please restart Claude Code (or OpenCode) to use the new version.
This is important because the updated CLI and plugins will not take effect until the IDE is restarted.
Notes
rp1 update handles the full lifecycle using the appropriate package manager (Homebrew, Scoop, or manual)
rp1 update plugins remains available for plugin-only repair or targeted tool refresh
- The command is safe to run even if you are already on the latest version