pm2insomnia 0.1.0

CLI to convert Postman collections into Insomnia imports

pm2insomnia

Move your Postman collections to Insomnia in seconds — no manual work.

Install • Usage • What gets converted • License

---

If your team exports collections from Postman but you prefer working in Insomnia, pm2insomnia does the conversion for you. Drop in a Postman export, get an Insomnia file ready to import — folders, requests, environments, auth, and examples included.

Install

The easiest way is with pipx, which installs the tool globally and keeps it isolated from your Python environment:

pipx install pm2insomnia

That's it. The pm2insomnia command is now available anywhere in your terminal.

Don't have pipx? Install it first:

pip install pipx

Usage

Convert a collection

pm2insomnia convert --input my-collection.postman.json

This creates my-collection.insomnia.json in the same folder. Open Insomnia, go to Import, and select that file.

Want to include your Postman environments too?

pm2insomnia convert \
  --input my-collection.postman.json \
  --environment my-environments.json

Export a versioned bundle

If you want to store the collection and API docs together in a repository:

pm2insomnia bundle \
  --input my-api-1.9.1.postman.json \
  --workspace-name "My API" \
  --output-dir exports/

This generates a tidy folder structure:

exports/
  collections/my-api/1.9.1/my-api.insomnia.json
  api-docs/my-api/1.9.1/README.md

You can also attach an OpenAPI spec:

pm2insomnia bundle \
  --input my-api-1.9.1.postman.json \
  --workspace-name "My API" \
  --spec openapi.yaml \
  --environment environments.zip \
  --output-dir exports/

Importing in Insomnia

1. Open Insomnia → Import
2. Select the .insomnia.json file
3. Done — your collection, environments, and examples are ready

Options

Flag	What it does
--input	Path to your Postman collection JSON
--environment	Postman environment file (.json or .zip). Repeat for multiple files
--output	Where to write the Insomnia file (default: same folder as input)
--output-dir	Write the output into a specific directory
--workspace-name	Override the workspace name shown in Insomnia
--pretty	Format the JSON output so it's readable
--strict	Fail with exit code 2 if anything couldn't be converted

What gets converted

✅ Folders and subfolders
✅ Requests — method, URL, headers, query params
✅ Request and folder descriptions
✅ Body — raw, form, and URL-encoded
✅ Path variables
✅ Bearer auth
✅ Saved response examples
✅ Collection variables → Insomnia base environment
✅ Postman environments → Insomnia sub-environments

What doesn't convert

These Postman features have no direct equivalent in Insomnia and are skipped. The tool will warn you when it encounters them:

• Pre-request and test scripts
• Auth types other than Bearer
• GraphQL body mode
• Variable resolution (placeholders are kept as-is)

License

MIT. See LICENSE.