Koh

Koh is an agent-friendly interface to Kong Insomnia, allowing tools like Claude Code or Codex to interact directly and deterministically with collections, requests, OpenAPI specs and other things stored in Insomnia.

Get Started

Install

npm install -g koh-cli

Usage

koh <command> [options] --project <path>

--project points to a directory containing Insomnia v5 YAML files (files whose first line contains insomnia.rest). Defaults to the current directory. Git projects only for now (see Roadmap and Limitations).

For more, see Detailed Usage below.

Learn More

Development State

This CLI is currently in Tech Preview (i.e. Alpha). This means that we are in the early stages of development: it is safe to use, but not recommended for production or mission-critical situations or deployments. The CLI or any part of it is subject to change or removal at any time, at Insomnia's sole discretion.

Though the long term vision is to replace and enhance the existing Inso CLI over the next 6-12 months or more, Koh does not currently offer feature parity with Inso. Similarly, Koh does not yet offer access to all Insomnia functionality. We are in active development through Q3 2026, but no specific timeline is yet available for parity with Inso or Insomnia.

Roadmap and Limitations

A list of things Koh does not yet support, in roughly the order we hope to address them.

• Only supported in Git Sync projects. Local and Cloud support is planned soon.
• Does not offer access to secrets, authentication, native vault integrations or other secure content.
• Only works on "files" inside Insomnia (collections, specs, etc). Cannot be used for:
  • Administration tasks like inviting users
  • Configuration tasks like creating projects
• See the Risks portion of this document.

Risks

By using Koh you accept sole responsibility for these risks:

• Like many developer tools, Koh currently runs with the same permissions and identity as the person using it. You should be aware of what it may have access to or allow an agent/LLM to do.
• LLMs are non-deterministic and may hallucinate or create unpredictable results. Review results carefully before relying on them. Koh is a "dumb pipe" — it does no thinking and contains no AI itself.

Detailed Usage

Collections

koh collection list
koh collection show <id|name>
koh collection create --name <name> [--description <desc>] [--file-path <path>]
koh collection update <id|name> --name <name>
koh collection remove <id|name>

Requests

koh request list [--collection <id|name>]
koh request show <id|name> [--collection <id|name>]
koh request create --name <name> [--collection <id|name>] [--parent <id>] [options]
koh request update <id|name> [--collection <id|name>] [options]
koh request remove <id|name> [--collection <id|name>]

--collection scopes the operation to a single collection file. Required for create when --parent is a folder ID rather than a collection ID.

Import

koh import oas collection <file> [--target <id|name>]
koh import oas document <file> [--target <id|name>]
koh import curl --from-file <path> --collection <id|name>
koh import curl - --collection <id|name>                     # read from stdin
koh import curl '<curl>' --collection <id|name> [--name <name>]

• import oas collection generates collection requests from the OAS.
• import oas document stores the OAS under spec.contents and generates matching requests inside the document.
• With --target, the CLI updates the matching resource by ID or exact name, or creates a resource with that name when no match exists.
• import curl parses a cURL command string and creates a single request in an existing collection.

Global options

| Flag | Description | | ------------------ | ------------------------------------------ | | --project <path> | Project directory (default: cwd) | | --agent | Output structured JSON (for LLM/agent use) | | --verbose | Show debug logs | | -v, --version | Show version |

Agent output

Pass --agent to get structured JSON responses:

{ "data": { ... } }

{ "error": "Collection not found: My API" }

Feedback

Your feedback is critical to how we develop this CLI. Please create issues or discussions in the Insomnia GitHub repo to share your feedback.

Versions

Version 0.3 — June 24, 2026

• First public release.
• Support for collections, requests and Open API Specs.
• Support for Import.