From a04b1aadeeb911757a99c61f5f3d345f2b79d95c Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Wed, 8 Jul 2026 14:06:38 +0200 Subject: [PATCH 1/9] feat(insomnia): koh landing page --- app/_landing_pages/koh.yaml | 176 ++++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 app/_landing_pages/koh.yaml diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml new file mode 100644 index 00000000000..11ab8bf016a --- /dev/null +++ b/app/_landing_pages/koh.yaml @@ -0,0 +1,176 @@ +metadata: + title: Koh CLI, the agent-friendly CLI for Insomnia + content_type: landing_page + description: This page is an introduction to Koh CLI, an agent-friendly command line tool for Insomnia. + tech_preview: true + breadcrumbs: + - /insomnia/ + products: + - insomnia + tags: + - design-apis + - test-apis + +rows: + - header: + type: h1 + text: "Koh CLI" + + - header: + type: h2 + text: What is Koh CLI? + columns: + - blocks: + - type: text + config: | + 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 works only with Insomnia [Git projects](/insomnia/storage/#git-sync). For the package and detailed usage, see [koh-cli on npm](https://www.npmjs.com/package/koh-cli#detailed-usage). + + - header: + type: h2 + text: "Install Koh CLI" + columns: + - blocks: + - type: text + config: | + 1. Install with npm: + ```bash + npm install -g koh-cli + ``` + 1. Check that Koh was properly installed: + ```bash + koh --version + ``` + - header: + columns: + - header: + type: h2 + text: "How does Koh CLI work?" + blocks: + - type: text + config: | + 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: + + ```bash + koh skills install [directory] --agent + ``` + + This 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](/insomnia/storage/#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 ` option to point to a different project directory: + + ```bash + koh collection list --project /path/to/project + ``` + + To produce structured JSON that AI agents and LLM workflows can parse, add the `--agent` flag to any command: + + ```bash + koh collection list --agent + ``` + + Koh currently supports Git projects only, so set up [Git Sync](/insomnia/storage/#git-sync) before running Koh commands. + + - header: + text: "What Koh CLI do?" + type: h2 + columns: + - blocks: + - type: x_with_y + config: + border: true + type: h2 + headers: + - Commonly used Koh CLI commands + + items: + - text: | + List all collections in the project + action: + type: command + config: + cmd: koh + args: + - collection + - list + - --agent + - text: | + Show a collection's details + action: + type: command + config: + cmd: koh + args: + - collection + - show + - '"collection name"' + - --agent + - text: | + List the requests in a collection + action: + type: command + config: + cmd: koh + args: + - koh + - request + - list + - --collection + - '"collection name"' + - --agent + + - text: | + Import an OpenAPI spec as a new document + action: + type: command + config: + cmd: koh + args: + - import + - oas + - document + - '"OpenAPI document name"' + - --agent + - text: | + List the operations defined in a document's OpenAPI spec + action: + type: command + config: + cmd: koh + args: + - koh + - document + - spec + - operation + - list + - --document + - '"API name"' + - --agent + - header: + type: h2 + text: Frequently asked questions + columns: + - blocks: + - type: faqs + config: + - q: What's the difference between Koh CLI and Inso CLI? + a: | + Both are command line tools for Insomnia, but they're built for different use cases: + + * **[Inso CLI](/inso-cli/)** is designed for people and CI/CD pipelines. Use it 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 AI agents, such as Claude Code or Codex. It exposes collections, requests, and OpenAPI specs as structured commands (use the `--agent` flag for JSON output) and installs skills that teach agents how to operate on your projects. Koh CLI works only with Insomnia [Git projects](/insomnia/storage/#git-sync). + + In short, reach for Inso CLI to automate testing and linting yourself, and Koh CLI to let an AI agent work with your Insomnia data. + - header: + type: h2 + text: Detailed usage + columns: + - blocks: + - type: related_resources + config: + - text: npm package documentation + type: blog + url: https://www.npmjs.com/package/koh-cli#detailed-usage From 222f8a93c53d51a159a5a113d947c3488d2dff0d Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Wed, 8 Jul 2026 14:16:49 +0200 Subject: [PATCH 2/9] feat(insomnia): add landing page at top navigation + card on insomnia landing page --- app/_data/top_navigation.yml | 6 ++++++ app/_landing_pages/insomnia.yaml | 12 +++++++++++- 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/app/_data/top_navigation.yml b/app/_data/top_navigation.yml index b3adf4080ef..4f9496966dd 100644 --- a/app/_data/top_navigation.yml +++ b/app/_data/top_navigation.yml @@ -17,6 +17,9 @@ platform: - text: Inso CLI url: /inso-cli/ icon: /assets/icons/code.svg + - text: Koh CLI + url: /koh/ + icon: /assets/icons/ai.svg - text: Terraform url: /terraform/ icon: /assets/icons/terraform.svg @@ -142,6 +145,9 @@ ai_tools: - text: Inso CLI url: /inso-cli/ icon: /assets/icons/code.svg + - text: Koh CLI + url: /koh/ + icon: /assets/icons/code.svg support: - text: Community diff --git a/app/_landing_pages/insomnia.yaml b/app/_landing_pages/insomnia.yaml index bc57fed791d..f87398284c9 100644 --- a/app/_landing_pages/insomnia.yaml +++ b/app/_landing_pages/insomnia.yaml @@ -118,7 +118,17 @@ rows: icon: /assets/icons/terminal.svg cta: text: Learn more - url: /inso-cli/ + url: /inso-cli/ + - blocks: + - type: card + config: + title: Koh CLI + description: Let AI agents like Claude Code work with your Insomnia collections, requests, and specs. + icon: /assets/icons/ai.svg + tech_preview: true + cta: + text: Learn more + url: /koh/ - header: type: h2 From c1110aaddbab4f35ce5c26546ec0c34b34f03de0 Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Wed, 8 Jul 2026 14:45:39 +0200 Subject: [PATCH 3/9] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- app/_data/top_navigation.yml | 2 +- app/_landing_pages/koh.yaml | 6 ++---- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/app/_data/top_navigation.yml b/app/_data/top_navigation.yml index 4f9496966dd..a458f070cb4 100644 --- a/app/_data/top_navigation.yml +++ b/app/_data/top_navigation.yml @@ -147,7 +147,7 @@ ai_tools: icon: /assets/icons/code.svg - text: Koh CLI url: /koh/ - icon: /assets/icons/code.svg + icon: /assets/icons/ai.svg support: - text: Community diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index 11ab8bf016a..df847c86fd5 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -75,7 +75,7 @@ rows: Koh currently supports Git projects only, so set up [Git Sync](/insomnia/storage/#git-sync) before running Koh commands. - header: - text: "What Koh CLI do?" + text: "What can Koh CLI do?" type: h2 columns: - blocks: @@ -94,7 +94,7 @@ rows: config: cmd: koh args: - - collection + - collection - list - --agent - text: | @@ -115,7 +115,6 @@ rows: config: cmd: koh args: - - koh - request - list - --collection @@ -141,7 +140,6 @@ rows: config: cmd: koh args: - - koh - document - spec - operation From d09740a8ccf01e67832adfe6d3968e1444bd3719 Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Thu, 9 Jul 2026 16:24:30 +0200 Subject: [PATCH 4/9] Apply suggestions from code review Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com> --- app/_landing_pages/koh.yaml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index df847c86fd5..10340659f19 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -25,6 +25,7 @@ rows: config: | 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](/inso-cli/), see [the FAQ section](#frequently-asked-questions). Koh CLI works only with Insomnia [Git projects](/insomnia/storage/#git-sync). For the package and detailed usage, see [koh-cli on npm](https://www.npmjs.com/package/koh-cli#detailed-usage). - header: @@ -158,8 +159,8 @@ rows: a: | Both are command line tools for Insomnia, but they're built for different use cases: - * **[Inso CLI](/inso-cli/)** is designed for people and CI/CD pipelines. Use it 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 AI agents, such as Claude Code or Codex. It exposes collections, requests, and OpenAPI specs as structured commands (use the `--agent` flag for JSON output) and installs skills that teach agents how to operate on your projects. Koh CLI works only with Insomnia [Git projects](/insomnia/storage/#git-sync). + * **[Inso CLI](/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 `--agent` flag for JSON output) and installs skills that teach agents how to operate on your projects. Koh CLI is currently in [Tech Preview](/insomnia/release-policy/#release-types) and works only with Insomnia [Git projects](/insomnia/storage/#git-sync). In short, reach for Inso CLI to automate testing and linting yourself, and Koh CLI to let an AI agent work with your Insomnia data. - header: From 3494beb2557ac2c869b54ab0ceb2f60a90be5909 Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Thu, 9 Jul 2026 16:31:20 +0200 Subject: [PATCH 5/9] fix: frontmatter --- app/_landing_pages/koh.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index 10340659f19..c15e5a194f8 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -25,7 +25,8 @@ rows: config: | 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](/inso-cli/), see [the FAQ section](#frequently-asked-questions). + Koh CLI isn't the same as [Inso CLI](/inso-cli/), see [the FAQ section](#frequently-asked-questions). + Koh CLI works only with Insomnia [Git projects](/insomnia/storage/#git-sync). For the package and detailed usage, see [koh-cli on npm](https://www.npmjs.com/package/koh-cli#detailed-usage). - header: From cd254e79bc3fe3565d2c1c7ebe66454ef374cf7a Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Thu, 9 Jul 2026 19:48:31 +0200 Subject: [PATCH 6/9] Update app/_landing_pages/koh.yaml Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_landing_pages/koh.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index c15e5a194f8..a934ea4a419 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -163,7 +163,7 @@ rows: * **[Inso CLI](/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 `--agent` flag for JSON output) and installs skills that teach agents how to operate on your projects. Koh CLI is currently in [Tech Preview](/insomnia/release-policy/#release-types) and works only with Insomnia [Git projects](/insomnia/storage/#git-sync). - In short, reach for Inso CLI to automate testing and linting yourself, and Koh CLI to let an AI agent work with your Insomnia data. + 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. - header: type: h2 text: Detailed usage From 1e81122b8b8cc224c1933ff12474e9fe1fda316e Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Fri, 10 Jul 2026 11:14:21 +0200 Subject: [PATCH 7/9] Update app/_landing_pages/koh.yaml Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_landing_pages/koh.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index a934ea4a419..ccbeb71e82a 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -27,7 +27,7 @@ rows: Koh CLI isn't the same as [Inso CLI](/inso-cli/), see [the FAQ section](#frequently-asked-questions). - Koh CLI works only with Insomnia [Git projects](/insomnia/storage/#git-sync). For the package and detailed usage, see [koh-cli on npm](https://www.npmjs.com/package/koh-cli#detailed-usage). + Koh CLI only works with Insomnia [Git projects](/insomnia/storage/#git-sync). For the package and detailed usage, see [koh-cli on npm](https://www.npmjs.com/package/koh-cli#detailed-usage). - header: type: h2 From 29998c88b853efc434938624fc447b208333f3d1 Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Wed, 22 Jul 2026 11:09:03 +0200 Subject: [PATCH 8/9] Update app/_landing_pages/koh.yaml Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_landing_pages/koh.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index ccbeb71e82a..d96116df2aa 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -2,6 +2,7 @@ metadata: title: Koh CLI, the agent-friendly CLI for Insomnia content_type: landing_page description: This page is an introduction to Koh CLI, an agent-friendly command line tool for Insomnia. + permalink: /insomnia/koh/ tech_preview: true breadcrumbs: - /insomnia/ From 00a407c7a99425397bd424365facbddd4bf07324 Mon Sep 17 00:00:00 2001 From: Julia <101819212+juliamrch@users.noreply.github.com> Date: Wed, 22 Jul 2026 11:35:39 +0200 Subject: [PATCH 9/9] add blog post link --- app/_landing_pages/koh.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/app/_landing_pages/koh.yaml b/app/_landing_pages/koh.yaml index d96116df2aa..fa8cf75b8be 100644 --- a/app/_landing_pages/koh.yaml +++ b/app/_landing_pages/koh.yaml @@ -167,7 +167,7 @@ rows: 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. - header: type: h2 - text: Detailed usage + text: Related resources columns: - blocks: - type: related_resources @@ -175,3 +175,7 @@ rows: - text: npm package documentation type: blog url: https://www.npmjs.com/package/koh-cli#detailed-usage + - text: | + Insomnia’s Agent-Friendly CLI tool, Koh: A Standardized Interface Between Your Agent and Your API Context + type: blog + url: https://konghq.com/blog/product-releases/koh-cli-api-context-for-agents/ \ No newline at end of file