Running into a problem? This page covers the most common issues users encounter with Straion. Jump to the relevant section:
Prerequisites
- Access to one or more of these coding agents: Claude Code (minimum version 2.1.84), Cursor, or GitHub Copilot
- A Straion account
- MacOS/Windows and Node.js v22+
- Sufficient permissions on your computer to install the Straion CLI
Check Agent Setup
Before connecting Straion, verify your coding agent CLI is installed. Run the command for your agent:
| Agent | Check command | Supported version |
|---|---|---|
| Claude Code | claude --version | > 2.1.84 |
| GitHub Copilot | copilot --version | > 1.0.0 |
| Cursor | agent --version | > 3.0.0 |
| OpenCode | opencode --version | > 0.14.4 |
If a command is not found, follow the install guide linked in the table above.
Firewall Issues
Some corporate or network firewalls may block outbound requests from the Straion CLI. If you’re seeing connection errors or timeouts, check with your network administrator to ensure that outbound HTTPS traffic to Straion’s services is allowed.
Permission Issues
Double-check your user token or generate a new one in the User Settings. The token inherits your permissions and can be scoped with an expiration date.
Common issues
Agent setup finished, but skills are not available
Try upgrading your agent if you have ran straion and performed the agent setup or ran straion setup, but the skills are not available inside your agent.
More Coming Soon
Troubleshooting content is on its way. If you’re running into an issue, reach out to support via email at support@straion.com or on Discord and we’ll help you get unblocked.