Troubleshooting
Running into a problem? This page covers the most common issues users encounter with Straion. Jump to the relevant section:
Prerequisites
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “Common issues”Agent setup finished, but skills are not available
Section titled “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
Section titled “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.