composio version

Display the current Composio CLI version

The composio version command displays the current version of the Composio CLI.

Usage

composio version

Description

Displays the semantic version (semver) of the installed CLI binary.

Examples

Display Version

composio version

Output:

◇  0.1.33

Capture Version in Scripts

# Get version as plain string (piped mode)
VERSION=$(composio version 2>/dev/null)
echo "CLI Version: $VERSION"

Piped output:

0.1.33

Check Version Programmatically

# Compare version before running commands
VERSION=$(composio version 2>/dev/null)
if [[ "$VERSION" < "0.1.30" ]]; then
  echo "Please upgrade: composio upgrade"
else
  echo "Version OK: $VERSION"
fi

Display Full CLI Help

composio --help

Shows all available commands and global options.

Output Format

Interactive Mode (TTY)

• stdout: Silent (no data output)
• stderr: Decorated output with CLI formatting
• Human-readable display

Example:

◇  0.1.33

Piped Mode (Not TTY)

• stdout: Plain version string only
• stderr: Silent (all decoration suppressed)
• Machine-readable for scripts

Example:

composio version | cat
# Output: 0.1.33

Version Format

The CLI uses semantic versioning (semver):

MAJOR.MINOR.PATCH

• MAJOR: Breaking changes (e.g., 1.0.0 → 2.0.0)
• Minor: New features, backward compatible (e.g., 0.1.0 → 0.2.0)
• Patch: Bug fixes, backward compatible (e.g., 0.1.0 → 0.1.1)

Example: 0.1.33

• Major: 0 (pre-1.0, API may change)
• Minor: 1 (feature set)
• Patch: 33 (bug fix iteration)

Version Source

The version is read from the CLI’s embedded package.json:

{
  "name": "@composio/cli",
  "version": "0.1.33"
}

This is baked into the binary at build time.

Checking for Updates

To check if a newer version is available:

composio upgrade

The upgrade command:

1. Fetches the latest release from GitHub
2. Compares with your current version
3. Upgrades if a newer version exists

Related Commands

• composio upgrade - Update to the latest version
• composio --help - Display CLI help

Next Steps

upgrade

Update your CLI

Installation

Installation guide