What is Koh CLI?
Koh CLI is an agent-friendly interface to Insomnia, allowing tools like Claude Code or Codex to interact directly with collections, requests, OpenAPI specs and other data stored in Insomnia.
Koh CLI isn’t the same as Inso CLI, see the FAQ section.
Koh CLI only works with Insomnia Git projects. For the package and detailed usage, see koh-cli on npm.
Install Koh CLI
- Install with npm:
npm install -g koh-cli - Check that Koh was properly installed:
koh --version
How does Koh CLI work?
Koh provides skills that teach AI agents how to operate on your Insomnia projects. Install the bundled skills into your agent’s skills directory with:
koh skills install [directory] --agentThis installs globally the skills into your agents /skills/ directory. Point Koh at a different base directory by passing it as an argument, and add --force to replace previously installed skill files.
Under the hood, Koh operates on a local Insomnia Git project when you enable Git Sync. Your collections, documents, and requests are stored as .yaml files that Koh reads and updates directly, so any changes are reflected in Insomnia without an import or export step.
By default, Koh uses the current working directory as the project. Use the --project <path> option to point to a different project directory:
koh collection list --project /path/to/projectTo produce structured JSON that AI agents and LLM workflows can parse, add the --agent flag to any command:
koh collection list --agentKoh currently supports Git projects only, so set up Git Sync before running Koh commands.
What can Koh CLI do?
Commonly used Koh CLI commands
List all collections in the project
koh collection list --agentShow a collection’s details
koh collection show "collection name" --agentList the requests in a collection
koh request list --collection "collection name" --agentImport an OpenAPI spec as a new document
koh import oas document "OpenAPI document name" --agentList the operations defined in a document’s OpenAPI spec
koh document spec operation list --document "API name" --agentFrequently asked questions
What’s the difference between Koh CLI and Inso CLI?
Both are command line tools for Insomnia, but they’re built for different use cases:
- Inso CLI is designed for people and CI/CD pipelines. Use it in production to lint OpenAPI specs, run collections and tests, and automate Insomnia workflows in your terminal or continuous integration environment. Inso CLI can read Insomnia data from a Git project or from the local Insomnia app data directory.
-
Koh CLI is designed for both humans and AI agents, such as Claude Code or Codex. It exposes collections, requests, and OpenAPI specs as structured commands (use the
--agentflag for JSON output) and installs skills that teach agents how to operate on your projects. Koh CLI is currently in Tech Preview and works only with Insomnia Git projects.
In short, use the Inso CLI to automate testing and linting yourself, and Koh CLI to let an AI agent work with your Insomnia data.