Background SwirlPwnity Mascot

From chaos to control

|

Pwnity is a high-performance, session-based framework that turns your scattered tools into a unified arsenal. With dynamic payload generation, automatic asset parsing, and a local-first philosophy, it's the environment built by pentesters, for pentesters.

Live Operations

Experience the speed and efficiency of the Pwnity CLI.

pwnity --cli
pwnity> _

The Pwnity Command Center

A multi-layered ecosystem designed for every stage of the engagement.

The Heart: CLI (Core)

FREE

A powerful, session-based shell that wraps your favorite tools. Build once, execute everywhere.

Smart Context

Dynamic Placeholders

Use $target.ip or $wordlist.path in any tool template.

Auto-Parsing

Update a URL and Pwnity resolves IP, domain, and TLD instantly.

Workspace Presets

Save entire session states (Target + Tool + Wordlist) as reusable templates.

Magic Gathering

One-Command Recon

target gather all runs DNS, WHOIS, HTTP, and Geo-IP at once.

Header Analysis

Automatic SSL/HTTP header extraction.

Subdomain Intelligence

Integrated domain decomposition.

Interactive Dashboard

Session Overview

Live context dashboard via overview.

Background Jobs

Monitor scans with bg and jobs list.

Heartbeat Monitoring

Real-time uptime tracking.

No-DB Architecture

JSON-Only Storage

JSON files for easy version control and syncing.

Portable Reports

Generate Markdown summaries instantly.

Tool Agnostic

Native wrapping of binary tools without scripts.

Pure Portability

CORE

No Database. No Pain.

Pwnity stores everything as local JSON files. No SQL dumps to manage, no database services to maintain. Simply copy your project folder, and your entire engagement context goes with you.

Audit-Ready Logbook

Every command execution is immutably recorded with timestamps and full output. Generate human-readable reports in seconds for instant stakeholder delivery.

pwnity/
data/
library/ HackTricks.json
parsers/ nmap.json
reports/
targets/ acme.json
tools/ ffuf.json
wordlists/ rockyou.json

The Kill Chain

Pwnity streamlines your entire process into a logical, repeatable flow. No more chaos, just pure efficiency.

1

Define Your Target

Initialize your target with a URL. Pwnity automatically resolves the IP, identifies the domain/TLD, and parses query parameters into placeholders.

target add web-server
target update web-server url http://192.168.1.10/login
2

Template Your Arsenal

Create reusable tool definitions. Use $target.ip, $target.base_url, and other placeholders to make your tools adapt to any session.

tool add gobuster
tool update gobuster command dir
tool update gobuster dir param "-u $target.base_url -w $wordlist.path"
3

Assemble the Session

Load your target, tool, and wordlist. Everything is now linked. Type 'overview' to see your interactive dashboard.

target load web-server
tool load gobuster
wordlist load common-dirs
overview
4

Foreground or Background

Execute your commands with precision. Use 'now' for immediate output or 'bg' to run long scans while you continue working.

pwn dir now  # Real-time output
pwn dir bg   # Background scan
5

Automated Extraction

Apply regex-based parsers to finished jobs. Pwnity extracts structured findings and offers an interactive checklist to save them.

parser apply common 3a8f
[*] Applying parser 'common'...
[+] Found 2 unique matches for rule 'ipv4'.
[+] Save findings? (Y/n)
6

Immutable Findings

Your report holds the ground truth. Notes, loot (credentials/keys), and parser findings are stored in one portable report file.

note add "Login vuln at /admin"
loot add credential admin:password123
report show

Initialization

Get Pwnity up and running in under a minute.

bash — install.sh
$ git clone git@github.com:pwnity/pwnity-cli.git
$ cd pwnity-cli
# Setup environment
$ python -m venv venv && source venv/bin/activate
$ pip install -r requirements.txt
# Start pwning
$ ./pwnity
Zero Dependencies

No database required. Pwnity uses local JSON files for maximum portability.

Modular Setup

Targets, tools, and wordlists are stored as reusable objects.

Fast Onboarding

Ships with example configurations to get you started immediately.

Future Trajectory

We believe in transparency. Here's a live look at our journey.

Pre-Beta (Stable)

  • Core CLI Framework
  • Session-Based Context Management
  • Tool, Target & Wordlist Library
  • Placeholder & Job System
  • Predefined Tool Presets

In Development

  • Initial Documentation & Guides
  • Advanced Reporting Formats
  • Official Kali Linux Package

Planned

  • Web UI (Pro)
  • Visual Node Editor
  • Community Hub for Sharing
  • AI Command Suggestions