Migration steps
1
Export from Insomnia
In Insomnia, go to Application → Preferences → Data → Export Data. Choose "All" or select specific collections. Export as Insomnia v4 JSON. Alternatively, export individual collections as Postman Collection v2.1 JSON for a direct import.
2
Create a Cruss account (optional)
Go to cruss.io/signup. No credit card required. You can also use Cruss as a guest — collections are stored locally in your browser. For team sync, create an account and invite your team members.
3
Import your collection
If you exported as Postman v2.1 JSON: right-click a collection in the Cruss sidebar → "Import from Postman" → paste your JSON. If you have an Insomnia v4 export, you can also import individual requests via the cURL import — right-click any collection → "Import from cURL" and paste cURL equivalents of your requests.
4
Set up environments
In Cruss, open the environment selector (top bar of the request builder) → "+ New". Add your environment name and recreate the key-value variable pairs from your Insomnia environments. Use {{variableName}} syntax to reference them.
# Insomnia uses _.variableName or {{variableName}}
# Cruss uses {{variableName}} — same syntax
GET {{baseUrl}}/users/{{userId}}5
Configure authentication
Open each request and go to the Auth tab. Select the auth type (Bearer Token, Basic Auth, or API Key) and enter your credentials. For team use, store tokens in environment variables ({{authToken}}) rather than hardcoding them.
6
Invite your team
Go to workspace Settings → Members → Invite by email. Cruss has no member limits — invite your entire team for free. Assign roles: admin, editor, or viewer.
7
Generate API documentation
Right-click any collection → "Generate docs". Cruss uses AI to generate a polished public API reference page from your collection. Publish it to get a shareable URL at cruss.io/docs/<slug>.
8
Install the VS Code extension (optional)
The Cruss VS Code extension works without an account in local mode. It gives you full request builder access inside VS Code with direct Node.js fetch — no CORS, no proxy needed for localhost.
code --install-extension Cruss-code.cruss
Frequently asked questions
Can I import Insomnia collections directly?
Cruss supports Postman Collection v2.1 JSON import. Export your Insomnia collection as Postman format (supported in recent Insomnia versions) and import directly. For older exports, the cURL import can bring in individual requests.
Does Cruss require an account?
No. The web app works in guest mode with collections stored in your browser. The VS Code extension works in local mode with no account. An account is only required for team sync and cloud storage.
What happened to my Insomnia plugins?
Cruss does not have a plugin system. Core functionality (auth, environments, GraphQL, collection runner, request chaining) is built in rather than requiring plugins.
Is Cruss open source?
The Cruss VS Code extension is open source under the MIT License, available at github.com/Cruss-API. The platform — web app and API — is proprietary software provided free of charge.
Does Cruss support gRPC?
Not currently. Cruss focuses on HTTP/REST and GraphQL APIs. gRPC support is on the roadmap.