OpenSana Docs

CLI Troubleshooting

Diagnose common setup, auth, runtime, and profile issues in the OpenSana CLI.

Common Problems

No profile found

Run:

opensana config show
opensana config list

Then either pass --profile explicitly or add the current directory to the right profile with opensana paths add.

Authentication failed

Check that the API key is valid for the target deployment and that the user still has access to the project.

connect starts but threads do not run

Check:

  • the selected profile points at the correct project
  • a supported runtime is installed locally
  • the thread is targeting a compatible CLI type

Claude CLI not found

Install Claude Code locally before using live thread execution with the Claude runtime.

Config files look wrong

Re-run:

opensana init mcp --force

or inspect the generated config file before overwriting it.

Init, MCP, and Editor Integration

Generate MCP config and install OpenSana skills for supported CLI targets.

Overview

Set up MCP and client-side skills so OpenSana works smoothly with local AI tools.

On this page

Common ProblemsNo profile foundAuthentication failedconnect starts but threads do not runClaude CLI not foundConfig files look wrong