# Insomnia > Insomnia API client for REST and GraphQL. Use for API testing. Use when this capability is needed. - Skill: `tomevault-io/insomnia` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/insomnia` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/insomnia/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/insomnia --- # Insomnia Insomnia is the lightweight alternative to Postman. v9.0+ focuses on **Local-First** philosophy (Local Vault) and **Git Sync**. ## When to Use - **Privacy**: "Local Vault" ensures your API keys never touch the cloud. - **GraphQL**: One of the best GraphQL clients with schema fetching and auto-complete. - **Simplicity**: Cleaner UI than Postman. ## Core Concepts ### Design Documents (OpenAPI) Write YAML config and generate code/tests. ### Git Sync Sync your collections to a Git repo (not a proprietary cloud). ### Plugins Community plugins for authentication and themes. ## Best Practices (2025) **Do**: - **Use Git Sync**: Treat your API collection as code. - **Use Environment Variables**: Switch contexts easily. **Don't**: - **Don't ignore the CLI**: `inso` is the CLI tool for running tests in pipelines. ## References - [Insomnia Documentation](https://docs.insomnia.rest/) --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/g1joshi) — claim your Tome and manage your conversions.