Summary: Organize your work with sessions (workspaces) and presets (saved session templates).

Sessions & Presets

pwnity uses Sessions and Presets to help you organize your work and automate repetitive setups.

Sessions: Your Workspace

A Session is your current, live workspace. It "remembers" which target, tool, and wordlist you have loaded, as well as any session-specific proxy settings.

The prompt always shows you the name of the active session, e.g., (project-x).

Commands:

  • session new <name>: Creates a new, empty session and switches to it.
  • session switch <name>: Switches to an existing session, restoring its context.
  • session list: Shows all available sessions.
  • session show: Displays what is currently loaded in the active session.
  • session destroy <name>: Deletes a session (but not the targets or tools themselves).

Presets: Your Templates

A Preset is a saved session configuration. It's a template for a common task.

Use Case: Imagine you always use gobuster with the directory-list-2.3-medium.txt wordlist to scan web servers. You can save this combination as a preset.

Commands:

  • preset save <name>: Saves the currently loaded items as a preset.
  • preset load <name>: Loads a preset. This creates a new session with the same name as the preset and loads all the saved items into it.
  • preset list: Shows all available presets.
  • preset show <name>: Displays the configuration of a preset.

Example:

tool load gobuster
wordlist load common-dirs
preset save gobuster-common

Later, in a new pwnity instance:

preset load gobuster-common

This will create a new session named gobuster-common and automatically load the gobuster tool and common-dirs wordlist.