Skip to main content

​
Overview

ZeroLimit features a comprehensive auto-update system that keeps both the desktop application and the CLI Proxy server current with the latest features, security patches, and bug fixes. Updates are checked automatically and can be installed with a single click.
Auto-Update Interface

​
Desktop Application Updates

ZeroLimit uses Tauri’s built-in updater for seamless desktop app updates.

​
Update Check Process

1

Automatic Check

ZeroLimit checks for updates periodically in the background
2

Notification

When an update is available, a toast notification appears
3

User Choice

Click “Update Now” in the notification or check manually in the About page
4

Download & Install

Update downloads in background, then installs and relaunches automatically

​
Manual Update Check

To manually check for ZeroLimit updates:
  1. Navigate to About page from the main menu
  2. Click Check for Updates button
  3. If an update is available:
    • Version number is displayed (e.g., “v1.2.0”)
    • Click Download and Install
  4. If up-to-date:
    • Green checkmark with “You’re on the latest version” message
The About page shows your current version number and build information.

​
CLI Proxy Updates

The CLI Proxy server has a separate update system managed through ZeroLimit’s Settings page.

​
Version Detection

ZeroLimit automatically detects:
  • Current Installed Version: The version currently running
  • Build Date: When the current executable was compiled
  • Latest Remote Version: The newest version available on GitHub

​
Checking for Proxy Updates

1

Open Settings

Go to Settings → CLI Proxy section
2

Click Check for Update

Press the Check for Update button
3

Review Information

Version info displays:
  • Current version (e.g., “v2.5.3”)
  • Build date (e.g., “Dec 15, 2024”)
  • Latest available version if newer
4

Update if Available

If an update exists, the Update Now button becomes visible

​
Update Process

When you click Update Now for CLI Proxy:
  1. Server Stops: Current CLI Proxy server is gracefully stopped
  2. Download: Latest version is fetched from GitHub releases
  3. Extract: Executable is extracted to the same directory
  4. Replace: Old executable is replaced with new one
  5. Restart: Server automatically restarts with new version
Updates are downloaded from official GitHub repositories:
  • Standard: router-for-me/CLIProxyAPI
  • Plus: router-for-me/CLIProxyAPIPlus

​
Version Comparison

ZeroLimit uses semantic versioning to determine if an update is needed:
  • Major.Minor.Patch format (e.g., 2.5.3)
  • Compares each segment numerically
  • Only prompts if remote version is newer
  • Example: 2.5.4 > 2.5.3 → Update available

​
Switching Between Standard and Plus

ZeroLimit allows switching between CLI Proxy versions without manual downloads:

​
Upgrade to Plus

  1. In Settings → CLI Proxy, find “Switch Version”
  2. Current status shows “Currently using Standard version”
  3. Click Switch to Plus
  4. ZeroLimit will:
    • Stop the Standard server
    • Download CLI Proxy Plus from GitHub
    • Extract to the same directory
    • Update the executable path
    • Start the Plus server
  5. Unlocks Plus-only providers (Copilot, Kiro)
Version switching checks for existing alternates in the same folder before downloading, saving bandwidth if you’ve previously used both versions.

​
Update Notifications

​
Desktop App Update Toast

When a ZeroLimit update is detected: 
🔔 Update Available
Version X.X.X is available.
[Update Now]  [Dismiss]
  • Duration: 10 seconds (auto-dismisses)
  • Action Button: “Update Now” starts download
  • Position: Bottom-right corner

​
CLI Proxy Update Indicator

In the Settings page:
  • Current version displays in gray
  • Latest version shows in green with arrow (→)
  • Update Now button highlighted in primary color
  • Checking… spinner during version check

​
Update Status States

​
Desktop App

StateDescriptionUI
IdleNo check performed”Check for Updates” button
CheckingQuerying update serverSpinner + “Checking…”
AvailableUpdate foundVersion display + “Download and Install”
DownloadingUpdate in progressProgress bar (0-100%)
ReadyDownloaded, installing”Restarting…” message
Up-to-dateNo update neededGreen checkmark + “Latest version”
ErrorUpdate failedRed error message

​
CLI Proxy

StateDescriptionUI
IdleNo check performed”Check for Update” button
CheckingQuerying GitHub APISpinner + “Checking…”
AvailableUpdate foundLatest version shown, “Update Now” button
UpdatingDownloading and installingSpinner + “Updating…”
SwitchingChanging versionSpinner + “Switching…”
ErrorUpdate failedToast error notification

​
Platform-Specific Behavior

​
Windows

  • Desktop Updates: .msi installer downloaded and executed
  • CLI Proxy Updates: .zip file extracted with cli-proxy-api.exe
  • Permissions: May require administrator approval for installer
  • Path Handling: Backslashes (\) in file paths

​
macOS

  • Desktop Updates: .dmg or .app.tar.gz downloaded
  • CLI Proxy Updates: .tar.gz extracted with cli-proxy-api binary
  • Permissions: Gatekeeper approval for first run
  • Path Handling: Forward slashes (/) in file paths

​
Linux

  • Desktop Updates: .AppImage or .deb downloaded
  • CLI Proxy Updates: .tar.gz extracted with cli-proxy-api binary
  • Permissions: Executable bit set automatically
  • Path Handling: Forward slashes (/) in file paths
On Linux, ensure you have libappindicator3-dev installed for full Tauri updater support.

​
Update Configuration

​
Update Endpoints

  • Desktop App: Tauri updater endpoint (configured in tauri.conf.json)
  • CLI Proxy: GitHub Releases API
    • Standard: https://api.github.com/repos/router-for-me/CLIProxyAPI/releases/latest
    • Plus: https://api.github.com/repos/router-for-me/CLIProxyAPIPlus/releases/latest

​
Update Channels

Current: Stable (default) Future versions may include:
  • Beta: Early access to new features
  • Nightly: Daily builds for testing

​
Troubleshooting Updates

Solutions:
  • Check your internet connection
  • Verify firewall allows Tauri updater
  • Try manual download from GitHub releases
  • Check disk space for download
Solutions:
  • Manually stop the server before updating
  • Close any terminal windows using the proxy
  • Check if antivirus is blocking the download
  • Ensure you have write permissions to the install directory
Solutions:
  • Verify your system architecture (x64 vs ARM)
  • Check GitHub releases for compatible build
  • Manually download correct version
  • Report issue if architecture detection fails
Solutions:
  • Ensure CLI Proxy is running
  • Verify you’re authenticated (Settings → Status)
  • Restart CLI Proxy server
  • Check API base URL and management key

​
Update Best Practices

1

Enable Auto-Start

Ensure Auto Start is enabled so updates persist across restarts
2

Check Regularly

Manually check for updates weekly if auto-check is disabled
3

Read Release Notes

Review what’s new before updating to understand changes
4

Backup Auth Files

Use “Download All” in Providers page before major updates

​
Manual Update Process

If automatic updates fail, you can update manually:

​
Desktop App

  1. Visit ZeroLimit Releases
  2. Download the latest version for your platform
  3. Install over existing installation
  4. Launch ZeroLimit - settings are preserved

​
CLI Proxy

  1. Visit CLIProxyAPI Releases (or Plus variant)
  2. Download the asset for your OS (e.g., windows_x86_64.zip)
  3. Extract to your existing CLI Proxy directory
  4. Replace the old executable
  5. Restart from ZeroLimit Settings

​
Version History

​
Desktop App

View version history:
  • About page shows current version
  • Release notes available on GitHub
  • Changelog included in repository

​
CLI Proxy

Track CLI Proxy versions:
  • Settings page displays installed version and build date
  • GitHub releases include detailed changelogs
  • API changelog available in CLI Proxy repository

​
Security Considerations

ZeroLimit only downloads updates from official sources:
  • Desktop: Tauri’s signed update endpoint
  • CLI Proxy: GitHub releases (HTTPS only)
Never download ZeroLimit or CLI Proxy from third-party sites.

​
Signature Verification

  • Desktop Updates: Tauri updater verifies digital signatures
  • CLI Proxy Updates: Downloaded via HTTPS from GitHub
  • Integrity Checks: File hashes validated where available

​
Automatic vs. Manual Updates

FeatureDesktop AppCLI Proxy
Auto Check✅ Background❌ Manual only
Auto Download✅ Optional❌ Manual trigger
Auto Install✅ After download✅ After manual trigger
Restart Required✅ Yes✅ Yes (server)
User Prompt✅ Toast notification❌ Settings page only
For maximum control, check for CLI Proxy updates monthly via the Settings page.

​
Rollback Support

​
Desktop App

If an update causes issues:
  1. Uninstall current version
  2. Download previous version from GitHub releases
  3. Install older version
  4. Disable auto-updates temporarily

​
CLI Proxy

If a CLI Proxy update fails:
  1. Keep backups of your executable before updating
  2. Replace new executable with backup
  3. Restart server from Settings
  4. Report issue on GitHub

​
Next Steps

Settings Guide

Configure update preferences and CLI Proxy settings

Troubleshooting

Common issues and solutions

Build docs developers (and LLMs) love

Get started for freeTalk to us