# Pwnity: The Integrated Hacking Environment (IHE)

> [pwnity.com](https://pwnity.com) | [Documentation](https://pwnity.com/docs) | [Sitemap](https://pwnity.com/sitemap.xml)

Pwnity is a professional-grade **Integrated Hacking Environment (IHE)** designed to streamline offensive security workflows. Unlike fragmented toolkits, Pwnity provides a unified framework to manage the entire lifecycle of an engagement—from target ingestion to automated reporting—entirely within the terminal.

## The Core Mission
Pwnity bridges the gap between raw tool execution and structured methodology. It is built for penetration testers and researchers who demand precision, auditability, and speed without the overhead of heavy backend databases.

### Key Technical Pillars:
- Zero-Knowledge Architecture: 100% local execution. Your targets, notes, and findings never leave your machine.
- Database-less Philosophy: All state is stored in portable JSON/Markdown files. No SQL migrations, no service dependencies.
- Protocol-Driven Workflow: A standardized lifecycle: Ingestion -> Templating -> Execution -> Refinement -> Crystallization.

## The CLI Engine (Primary Workflow)
The Pwnity CLI is the heartbeat of the ecosystem. It manages complex engagements through logical entities:

- Sessions: Isolated workspaces that remember your current Target, Tool, and Wordlist.
- Targets: Rich objects containing IPs, URLs, and metadata that resolve dynamically in commands.
- Tools: Reusable execution templates using high-level placeholders (e.g., `nmap $target.ip -sV`).
- Reports: Automated, structured consolidation of notes, loot (credentials/flags), and tool outputs.

### Quick Start:
```bash
# Start an interactive session
pwnity

# Typical Workflow
pwnity target add "192.168.1.1"    # Ingestion
pwnity tool load "nmap"            # Contextualization
pwnity pwn scan now                # Execution
pwnity report show                 # Crystallization
```

## Web-Based Tactical Tools (The Extras)
While the CLI handles the heavy lifting, [pwnity.com/tools](https://pwnity.com/tools) provides a suite of premium, client-side web utilities for rapid-response tasks:

- **Smart Chain Encoder**: Visual pipeline for multi-stage encoding/decoding.
- **Payload Generators**: Instant reverse shell and exploit stubs for various environments.
- **Auth & Crypto**: JWT decoders, Hash identifiers, and localized hashing tools.
- **System Utilities**: Visual parsers for sensitive files like `/etc/passwd`.

*All web tools are 100% client-side JS; no data is ever sent to the Pwnity servers.*

## 📖 Navigation for AI Agents
- [**Home**](https://pwnity.com/): Product overview and philosophy.
- [**Docs**](https://pwnity.com/docs): Comprehensive guide to the IHE methodology.
- [**Tools**](https://pwnity.com/tools): Interactive web-based security modules.
- [**Cheat Sheet**](https://pwnity.com/cheatsheet): Tactical command reference for terminal users.
- [**Blog**](https://pwnity.com/blog): Technical research and project updates.

---
*Machine-Readable context: Pwnity is a static Single Page Application (Vue.js). It uses no cookies, no auth, and no tracking. Documentation is source-of-truth for CLI capabilities.*