Skip to content

docs(insomnia): plugin sandbox, permissions, and troubleshooting pages (draft) - #6597

Draft
jackkav wants to merge 2 commits into
mainfrom
docs/insomnia-plugin-sandbox
Draft

docs(insomnia): plugin sandbox, permissions, and troubleshooting pages (draft)#6597
jackkav wants to merge 2 commits into
mainfrom
docs/insomnia-plugin-sandbox

Conversation

@jackkav

@jackkav jackkav commented Aug 7, 2026

Copy link
Copy Markdown

Insomnia plugin sandbox docs (draft)

Adds three new pages under app/insomnia/plugins/ documenting the sandboxed plugin model shipped in Insomnia 13.x, and registers them in the Insomnia nav (app/_indices/insomnia.yaml). Opened as a draft to iterate on.

New pages

  • Plugin sandbox and trust model (sandbox-and-trust.md) — in-process vs the QuickJS sandbox, the pluginSandboxEnabled setting (supersedes the templateTagSandboxEnabled experiment), the four execution modes, the per-plugin Full host access (elevated) opt-in, a migration guide, and a "what changed" (hardening vs. regression) table.
  • Plugin permissions (permissions.md) — the insomnia.permissions manifest (modules + capabilities), the default-deny baseline, and a capability reference.
  • Plugin troubleshooting (troubleshooting.md) — the "my plugin disappeared → disabled row with a reason" behavior (Custom plugins disappearing insomnia#10295), reload-recovers-after-fix, and current known limitations.

These complement the existing plugin-reference, context-object-reference, and hooks-and-actions pages (no overlap).

Reviewer notes — two inline TODOs before publishing

  • Module list in permissions.md is illustrative; it should be replaced with the canonical generated list (ALL_SANDBOX_MODULES in the Insomnia source) so it can't drift.
  • Known limitation: folder actions in troubleshooting.md is gated on triaging Folder plugin actions (requestGroupActions) broken insomnia#10292 — it may be a bug to fix rather than a limitation to document. That section is marked "do not finalize until triaged."

Frontmatter, callout syntax ({:.warning}), and nav registration follow the existing plugin pages.

🤖 Drafted by Claude Code

@netlify

netlify Bot commented Aug 7, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit adeba17
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a76010e84cb3f0008bec2fa
😎 Deploy Preview https://deploy-preview-6597--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant