FAQ

Data & Security

Where is my data stored?

All data is stored locally under ~/.soagents/, including session history, configuration, and skills. Nothing is uploaded to the cloud.

Is my API Key secure?

API Keys are stored in ~/.soagents/config.json locally and are only sent to the corresponding provider’s API. Make sure your computer user account is secured.

Providers

Can I use it without an API Key?

Yes. Select Anthropic (Subscription) provider and sign in with your Claude Pro or Max subscription.

Does it support OpenAI models?

Yes. Use OpenRouter to access GPT-5.4 and other OpenAI models, or add a custom provider.

Why are responses slow?

Possible causes:

• Provider API is slow (especially for large models)
• Unstable network connection
• Need to configure a proxy (for some international providers)

MCP

MCP is enabled but not working?

Try:

1. Check if the required runtime is installed (Node.js / Python)
2. Disable and re-enable in Settings
3. Restart SoAgents

Where can I find more MCPs?

Visit mcp.so or smithery.ai to browse community MCPs.

Application

Is Windows supported?

Both macOS and Windows versions are available. Download from GitHub Releases.

How do I update?

The app auto-detects new versions. When an update indicator appears at the bottom of the sidebar, click to update. You can also download the latest version from GitHub manually.

My conversations disappeared?

Check if the sidebar filter is set to “All”. If set to “Active”, archived sessions won’t show. You can also use the search function.

How do I free up storage?

Session data is in ~/.soagents/sessions/ — manually delete unneeded session folders. Logs are in ~/.soagents/logs/.