ResourcesTroubleshooting

CLI

Troubleshooting common CLI issues

Command not found

Verify the CLI is installed and in your PATH:

$which composio

If not found, reinstall:

$curl -fsSL https://composio.dev/install | bash

Or add to PATH:

$echo 'export PATH="$HOME/.composio:$PATH"' >> ~/.bashrc && source ~/.bashrc

Authentication errors

Check current authentication:

$composio whoami

Re-authenticate if needed:

$composio logout
>composio login

For CI/CD, use environment variable:

$export COMPOSIO_API_KEY="your-api-key"

Type generation issues

Project type not detected

Use language-specific commands:

$composio ts generate  # TypeScript
>composio py generate  # Python

Output directory missing

Specify output directory explicitly:

$composio generate --output-dir ./my-types

Debug CLI issues

Enable debug logging:

$composio --log-level debug [command]

Check version compatibility:

$composio version

Common issues

  • API key not found: Run composio login
  • Project type detection fails: Use language-specific commands or ensure you’re in project root
  • Network timeout: Check internet connection and proxy settings
  • Permission denied: Check directory write permissions

Getting help