Skip to content

self-update

Updates rp1 to the latest version using the appropriate package manager.

Synopsis

/self-update

/rp1-base/self-update

Description

The self-update command detects your rp1 installation method and runs the appropriate update command. It supports automatic updates for Homebrew and Scoop installations, and provides manual instructions for other installation methods.

Supported Package Managers

Installation Method Update Command Platform
Homebrew brew upgrade rp1 macOS, Linux
Scoop scoop update rp1 Windows
Manual Provides GitHub release link All

Exit Codes

The command returns specific exit codes to indicate the result:

Exit Code Meaning Action Required
0 Update successful Restart IDE
1 Update failed Check error message, retry or update manually
2 Manual update required Download from GitHub releases

Examples

Successful Update (Homebrew)

/self-update

/rp1-base/self-update

Expected output: 

Detecting installation method...
Homebrew installation detected

Updating rp1...
Successfully updated rp1 from 0.2.3 to 0.3.0

Manual Installation

When automatic update is not available:

Expected 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

Update Error

When the update fails:

Expected output: 

Error: brew upgrade failed: Permission denied

In this case, check file permissions or try updating manually.

Post-Update Steps

Restart Required

After updating, you must restart Claude Code (or OpenCode) to use the new version. The updated CLI will not take effect until the IDE is restarted.

Verify Update

After restarting your IDE, verify the update was successful:

rp1 --version

Manual Installation

For manual installations or when automatic update fails, download the latest version from GitHub:

GitHub Releases

Installation Options

Method Command
Homebrew (macOS/Linux) brew install rp1-run/tap/rp1
Scoop (Windows) scoop bucket add rp1 https://github.com/rp1-run/scoop-bucket && scoop install rp1
Direct download Download binary from GitHub releases

Safe to Run

The command is safe to run even if you are already on the latest version. In this case, the package manager will report no updates available:

Already up-to-date. rp1 is at version 0.3.0

Error Handling

Condition Behavior
Already on latest Reports "Already up-to-date"
Network error Returns error with suggestion to retry
Permission denied Returns error with suggestion to check permissions
Unknown installation Provides manual update instructions

See Also