selfpwntools

This repository is organized as a Codex skill bundle with a small Python runtime behind it.

The two primary deliverables are the skill folders under skills/:

• skills/pwntools-debug-operator/: operate tmux + pwntools + gdb.attach() sessions through autopwn-session
• skills/ida-reverse-operator/: bootstrap shared idalib-mcp --isolated-contexts and then use native IDA MCP tools

How to consume it

If Codex is exploring this repository, start from the skill directories, not from src/.

• Read each skill's SKILL.md
• Load only the referenced references/*.md files needed for the current task
• Reuse the bundled assets/ files instead of reconstructing templates from scratch

Runtime layer

The Python package under src/autopwn_platform/ now carries only the externally-usable reverse runtime:

• autopwn-reverse-bootstrap --help
• autopwn-reverse-workspace --help

The debug runtime is skill-local under skills/pwntools-debug-operator/runtime/ and is launched through the repository script:

• ./autopwn-session --help

The reverse runtime under src/ provides:

• shared reverse backend bootstrap and Codex MCP config emission
• reverse workspace persistence and lifecycle commands

Repository map

• skills/: Codex-facing skills, references, and reusable assets
• src/: reverse runtime implementations that remain externally callable
• tests/: regression coverage for CLI, adapters, bootstrap, and stores