Insomnia to Postman Converter

This project provides a simple way to convert Insomnia Collection files (YAML or JSON) into Postman v2.1.0 Collection JSON format. It maintains all request details including headers, body, authentication and other settings.

Features

• Converts Insomnia YAML or JSON to Postman JSON format
• Preserves request metadata, headers and body
• Maintains folder structure and request organization
• Supports authentication settings
• Command-line interface (CLI) for easy usage

Installation

You can install the CLI globally using npm:

npm install -g insomnia-to-postman

Or using yarn:

yarn global add insomnia-to-postman

Or using pnpm:

pnpm add -g insomnia-to-postman

Usage

After installation, you can use the CLI in two ways:

1. Using the global command:

insomnia-to-postman <input-file.yaml|input-file.json> [output-file.json]

2. Using npx:

npx insomnia-to-postman <input-file.yaml|input-file.json> [output-file.json]

Examples:

# Convert YAML collection
insomnia-to-postman ./my-collection.yaml ./my-collection.postman_collection.json

# Convert JSON collection
insomnia-to-postman ./my-collection.json ./my-collection.postman_collection.json

If you don't specify an output file, the tool will automatically create one in the same directory as the input file with the .postman_collection.json extension.

Development

If you want to contribute or run the project locally:

1. Clone this repository:

git clone https://github.com/igorfelipeduca/insomnia-to-postman.git

2. Install dependencies:

yarn install

3. Build the project:

yarn build

4. For development with auto-reload:

yarn dev

Importing the Postman Collection

Once the conversion is complete, you can import the generated Postman collection:

1. Open Postman
2. Click on Import in the top-left corner
3. Select Upload Files and choose your converted JSON file
4. Click Import to add the collection to your workspace

Troubleshooting

If you encounter any issues:

• Make sure your Insomnia collection file is valid (YAML or JSON)
• Check that the input file path is correct
• Ensure you have write permissions in the output directory
• For global command issues, try reinstalling the package:

  npm uninstall -g insomnia-to-postman
  npm install -g insomnia-to-postman

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.