Bundles

A bundle is a named container for probes. Every probe belongs to exactly one bundle. Bundles keep your probes organized — group them by target system, by team, or however makes sense for your workflow. Bundles can also be nested into a tree and scoped to projects so you only see what’s relevant to the work in front of you.

Bundles view — sidebar with bundle list and probes nested inside each bundle

Creating a bundle

Click New Bundle in the toolbar and enter a name. To create a bundle inside another one, open a bundle’s ⋯ menu and choose Add Sub-bundle.

Bundle actions

Every bundle has a ⋯ menu (revealed on hover) with:

Add Sub-bundle — create a child bundle nested underneath
Rename
Move bundle — re-parent the bundle, or move it back to the top level. A bundle cannot be moved into one of its own descendants.
Export — export the bundle and its probes as JSON

Nesting (the bundle tree)

Bundles form a tree: a bundle can contain both probes and other bundles. Expand and collapse branches with the caret; the open state is remembered. Use nesting to mirror how a target is structured — for example an Auth flows bundle containing OAuth and Login sub-bundles.

Bundle tree — a root bundle expanded to show a nested sub-bundle and its probes

The sidebar shows the bundle tree. You can:

Sort probes — toggle between Default order, A→Z, and Z→A using the sort button in the panel header
Resize the sidebar — drag the sidebar edge to adjust width (remembered across sessions)
Navigate by keyboard — arrow keys move the selection, Right/Left expand/collapse, Enter opens, F2 renames, Delete removes a probe

Bundles and projects

A bundle can belong to zero or more projects, which controls when it appears in the sidebar:

No project (free) — always visible, under an Unassigned section
One or more projects — visible only when one of those projects is the active project, under a Project: <name> section

This keeps the sidebar focused: switch the active project and only that project’s bundles (plus free ones) are shown. The same rule applies everywhere a bundle or probe is picked — chain step probe pickers, the project dashboard, move-probe targets, and the quick-create dropdown.

You link bundles to a project from the Project Dashboard — see Projects → Project Bundles. A bundle created while a project is active is linked to that project automatically; sub-bundles are created free so they always travel with their parent.

Adding a probe

Select a bundle, then click Add Probe (or use the quick-create protocol buttons in the toolbar). Choose the protocol and enter a probe name. The probe opens in the editor immediately.

Import and export

Probes and entire bundles can be exported as JSON and re-imported on any VirtuProbe instance. Use the export icon (↗) on a bundle or probe in the sidebar, and the import icon (↙) next to the Add buttons to import from a file.

See Import & Export for the file format reference.