🎯

insomnia

🎯Skill
g1joshi/agent-skills1 Installs9Last Updated Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill insomnia

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/insomnia
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/insomnia/
  • All projects ~/.claude/skills/insomnia/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Expert Insomnia REST/GraphQL/gRPC client assistance covering environment variables, request chaining, plugins, and test automation. Use when designing, testing, and debugging APIs.

Insomnia

Insomnia is the lightweight alternative to Postman. v9.0+ focuses on Local-First philosophy (Local Vault) and Git Sync.

When to Use

  • REST, GraphQL & gRPC API Design and Debugging: Modern, lightweight desktop API client with environment chaining.
  • Inso CLI Automation for CI/CD: Running automated API test suites and linting OpenAPI specifications in pipelines.
  • Environment & Variable Chaining: Extracting tokens from login endpoints and injecting them into subsequent requests.
  • Git-Sync Team Collaboration: Versioning API collections, design documents, and tests directly in Git repositories.

Quick Start

// Insomnia Base Environment Configuration
{
  "base_url": "https://api.staging.example.com/v1",
  "auth_token": "Bearer eyJhbGciOi...",
  "tenant_id": "tenant_1234"
}

Core Concepts

Environment Variables & Chained Request Responses

Extracting bearer token from authentication response:

// In Sub-Environment configuration
{
  "base_url": "https://api.staging.example.com",
  "client_id": "app_client_prod",
  "auth_token": "{% response 'body', 'req_login_01', 'b64::JC5hY2Nlc3NfdG9rZW4=::46b', 'no-history', 60 %}"
}

Subsequent requests reference {{ base_url }}/v1/users with header Authorization: Bearer {{ auth_token }}.

Inso CLI Test Execution in CI Pipelines

Running automated API test collections headlessly:

# Lint OpenAPI specification file
inso lint spec "Company API Spec"

# Run automated functional test suite against staging environment
inso run test "User Lifecycle Test Suite" --env "Staging" --ci

gRPC Service Invocation

Calling gRPC methods with server reflection:

  1. Create new request -> Select gRPC.
  2. Enter server URL: grpc.infra.internal:50051.
  3. Enable Server Reflection to auto-load Protobuf method definitions.
  4. Input JSON payload and click Send to stream responses.

Common Patterns

Automated CI Collection Testing with Inso CLI

Problem: Run Insomnia API tests automatically inside CI/CD pipelines.
Solution: Execute tests via inso CLI.

# Install inso CLI
npm install -g insomnia-inso

# Run test suite headlessly in CI
inso run test "User API Test Suite" --env "Staging" --ci

Best Practices

Do:

  • Sync Insomnia collections to Git repositories for version control and peer review of API changes.
  • Use Inso CLI in CI/CD pipelines to validate OpenAPI specifications and run regression tests.
  • Organize environments hierarchically (Base Environment -> Staging, Production sub-environments).
  • Use response chaining ({% response ... %}) to eliminate manual copy-pasting of auth tokens.

Don't:

  • Store plaintext production credentials in public Git-synced collections.
  • Skip OpenAPI linting; maintain clean, valid specs that generate accurate SDKs.
  • Duplicate request URLs across endpoints; reference {{ base_url }} consistently.

Troubleshooting

ErrorCauseSolution
SSL Certificate validation failed in InsomniaSelf-signed SSL certificate in local development.Uncheck "Validate SSL certificates" in Insomnia Preferences > General.
Template tag failed: Request has no responseChained request hasn't been executed yet.Execute the referenced upstream request (req_login) once.
CORS Error in Insomnia Web ClientWeb version subject to browser CORS policies.Use desktop native Insomnia client or configure CORS proxy.

References

More from this repository10