Skip to main content
The composio upgrade command updates your CLI installation to the latest available version.

​
Usage

composio upgrade

​
Description

The upgrade command:
  1. Fetches the latest release from GitHub
  2. Compares with your current version
  3. Downloads the appropriate binary for your platform
  4. Replaces the existing binary with the new version
  5. Verifies the installation

​
Examples

​
Basic Upgrade

composio upgrade
Output (when upgrade available): 
┌  composio upgrade
│
◇  Current version: 0.1.30
◇  Latest version: 0.1.33
│
◆  Downloading composio-darwin-aarch64.zip...
│  [████████████████████████████████] 100%
│
◇  Download complete
◇  Extracting binary...
◇  Installing to ~/.composio/bin/composio
│
◇  Successfully upgraded to 0.1.33
│
└  Done
Output (when already up-to-date): 
┌  composio upgrade
│
◇  You're already running the latest version (0.1.33)
│
└  Done

​
Verify Upgrade

composio upgrade
composio version
Confirms the new version is installed.

​
Platform Detection

The upgrade command automatically detects your platform and downloads the appropriate binary:
PlatformArchitectureBinary
Linuxx86_64composio-linux-x64.zip
LinuxARM64composio-linux-aarch64.zip
macOSIntelcomposio-darwin-x64.zip
macOSApple Siliconcomposio-darwin-aarch64.zip
Windows is not supported. Use WSL or install via npm (npm install -g @composio/cli).

​
Release Tags

CLI binaries are published as GitHub release assets with the tag format: 
@composio/cli@<semver>
Example: @composio/[email protected]
Legacy v<semver> tags (e.g., v0.1.24) are supported during the migration period for backward compatibility.

​
Environment Variables

The upgrade command supports these environment variables for customization:
​
COMPOSIO_GITHUB_API_BASE_URL
string
default:"https://api.github.com"
GitHub API base URL (useful for GitHub Enterprise)
​
COMPOSIO_GITHUB_OWNER
string
default:"ComposioHQ"
GitHub repository owner
​
COMPOSIO_GITHUB_REPO
string
default:"composio"
GitHub repository name
​
COMPOSIO_GITHUB_TAG
string
default:"latest"
Specific release tag to upgrade to
​
COMPOSIO_GITHUB_ACCESS_TOKEN
string
GitHub access token (prevents rate limiting during development)
​
DEBUG_OVERRIDE_VERSION
string
Override version for debugging (development use only)

​
Examples

​
Upgrade to Specific Version

COMPOSIO_GITHUB_TAG='@composio/[email protected]' composio upgrade
Downloads and installs version 0.1.24 instead of the latest.

​
Custom GitHub API (Enterprise)

export COMPOSIO_GITHUB_API_BASE_URL="https://github.company.com/api/v3"
export COMPOSIO_GITHUB_ACCESS_TOKEN="ghp_your_token"
composio upgrade
Uses a GitHub Enterprise instance.

​
Avoid Rate Limiting

export COMPOSIO_GITHUB_ACCESS_TOKEN="ghp_your_token"
composio upgrade
Provides a GitHub token to increase API rate limits.

​
Installation Location

The upgrade replaces the binary at: 
~/.composio/bin/composio
Or the location specified by COMPOSIO_INSTALL during initial installation.

​
Version Comparison

The CLI uses semantic versioning (semver) to compare versions:
  • Major: Breaking changes (e.g., 1.0.0 → 2.0.0)
  • Minor: New features (e.g., 0.1.0 → 0.2.0)
  • Patch: Bug fixes (e.g., 0.1.0 → 0.1.1)
The upgrade only proceeds if a newer version is available.

​
Troubleshooting

​
Permission Denied

If you get permission errors during upgrade: 
chmod +x ~/.composio/bin/composio
Or run the upgrade with appropriate permissions: 
sudo composio upgrade

​
Download Failures

If the download fails: 1. Check internet connection 2. Verify GitHub access: 
curl -I https://api.github.com/repos/ComposioHQ/composio/releases/latest
3. Use a GitHub token to avoid rate limits: 
export COMPOSIO_GITHUB_ACCESS_TOKEN="ghp_your_token"
composio upgrade

​
Rate Limiting

GitHub API has rate limits (60 requests/hour for unauthenticated users). If you hit the limit: 
Error: GitHub API rate limit exceeded
Solution: Provide a GitHub token: 
export COMPOSIO_GITHUB_ACCESS_TOKEN="ghp_your_token"
composio upgrade

​
Unsupported Platform

If your platform is not supported: 
Error: Unsupported platform: win32
Solution for Windows: Use WSL or install via npm: 
npm install -g @composio/cli

​
Manual Upgrade

If the automatic upgrade fails, you can manually upgrade: 
# Download the latest release
curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/main/install.sh | bash
This runs the installation script, which handles upgrades automatically.

​
Rollback

If you need to downgrade to a previous version: 
COMPOSIO_GITHUB_TAG='@composio/[email protected]' composio upgrade
Or reinstall from scratch: 
curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/main/install.sh | bash -s -- @composio/[email protected]

​
Next Steps

version

Check your CLI version

Installation

Installation guide

Build docs developers (and LLMs) love

Get started for freeTalk to us