insomnia-plugin-local-snapshot

Local-only redacted workspace snapshots for Insomnia. v1.1.0 adds a compact redacted JSON sidecar next to the Markdown snapshot for diffing and automation.

Local Snapshot exports a Markdown file and matching JSON file containing a redacted workspace export plus a small resource summary. It is intended as a quick safety backup before risky API work, migrations, imports, or destructive request sessions.

Features

• Exports a local Markdown snapshot
• Exports a compact redacted .json sidecar next to the Markdown file
• Uses Insomnia export with includePrivate: false
• Redacts secret-like values
• Counts requests, folders, environments, specs, and total resources
• Adds a SHA-256 fingerprint of the redacted snapshot
• Uses timestamped default filenames
• No sync backend
• No cloud account
• No telemetry
• No dependencies

Install

From Insomnia:

1. Open Preferences → Plugins
2. Enter insomnia-plugin-local-snapshot
3. Click Install Plugin

Manual macOS install:

cd "$HOME/Library/Application Support/Insomnia/plugins"
npm install insomnia-plugin-local-snapshot

Usage

Run:

Local Snapshot: Export Redacted Snapshot

The action writes two local files:

insomnia-local-snapshot-TIMESTAMP.md
insomnia-local-snapshot-TIMESTAMP.json

The JSON sidecar uses schema:

{
  "schema": "insomnia-local-snapshot/v1",
  "counts": {
    "total": 4,
    "requests": 1,
    "folders": 1,
    "environments": 1,
    "specs": 1
  },
  "redactedSha256": "...",
  "redactedExport": {}
}

The action is exposed through workspaceActions, requestGroupActions, and requestActions. In Insomnia 13 it may appear in the New Request dropdown.

Privacy

• Local-only
• No network calls
• No analytics
• No account required
• Exports with includePrivate: false
• Secret-like values are redacted before writing the snapshot

Development

git clone https://github.com/oliviajohns5/insomnia-plugin-local-snapshot.git
cd insomnia-plugin-local-snapshot
npm test
npm run test:packaged
npm pack --dry-run

Verified QA

• node --check main.js
• node --check test.js
• node --check real-insomnia-packaged-test.js
• node --check qa-packaged.js
• npm test
• npm run test:packaged
• npm pack --dry-run
• isolated tarball install
• package metadata validation
• credential literal scan

License

MIT