CLI for running Insomnia API collections and test suites, linting API specs, and exporting saved design documents.
$brew install inso
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
Inso is Insomnia's automation-focused CLI for taking API collections and specs out of the desktop app and into the shell. It runs request collections and unit test suites, lints API specs, and exports stored designs from Insomnia app data, Git-backed projects, or export files.
What It Enables
- Run saved request collections against chosen environments, globals, iteration data, and scripted request flows without opening the Insomnia app.
- Execute Insomnia unit test suites in CI, including request scripts, proxy settings, timeout controls, certificate toggles, and fail-fast exit behavior.
- Lint OpenAPI specs with Spectral rulesets and export API specs from Insomnia workspaces or export files for downstream validation or publishing.
Agent Fit
- Useful when a team already stores API definitions or test suites in Insomnia, because commands accept export files, Git-backed projects, or local app data and support
--cito suppress prompts. - Machine-readable output exists, but narrowly:
run collection --outputwrites JSON reports with safe, redacted, or plaintext detail, while most other commands emit human-oriented logs rather than--jsonstdout. - No native MCP surface or packaged skills tree was found for
inso; MCP code in this monorepo belongs to the desktop Insomnia app, not the CLI.
Caveats
- The CLI is tightly coupled to Insomnia's data model and identifiers, so it is much less useful if your API definitions and tests live outside Insomnia.
- Some flows still prompt for workspace or environment selection unless you pass explicit identifiers or use
--ci, and collection runs can execute embedded scripts with filesystem access scoped by--dataFolders.