# Drivers - Turn a REPL Session into a Shipped Binary

A **driver** is a small executable in `bin/` that wires `OptionParser` to one
or more `PWN::` calls. All 52 shipped `pwn_*` binaries follow the same
15-line template.

![History → Driver → CI](diagrams/history-to-drivers.svg)

## Workflow

1. **Prototype in the REPL** until the calls work.
2. `history` → copy the winning lines.
3. Drop them into the template below as `bin/pwn_<name>`.
4. `chmod +x bin/pwn_<name>` · add to `pwn.gemspec` executables · `rake install`.
5. (Optional) `learning_distill_skill(name: '<name>')` so the agent knows the
   procedure too.

## Template

```ruby
#!/usr/bin/env ruby
# frozen_string_literal: true

require 'optparse'
require 'pwn'

opts = {}
OptionParser.new do |o|
  o.banner = "USAGE: #{File.basename($PROGRAM_NAME)} [opts]"
  o.on('-tTARGET', '--target=TARGET', 'Required target') { |v| opts[:target] = v }
  o.on('-oDIR',    '--out=DIR',       'Output directory') { |v| opts[:out]    = v }
end.parse!

raise OptionParser::MissingArgument, '-t' unless opts[:target]

result = PWN::Plugins::NmapIt.port_scan(target: opts[:target])
PWN::Reports::Fuzz.generate(result: result, dir_path: opts[:out]) if opts[:out]
puts result
```

## Three artifact types from one REPL session

| Artifact | Made with | Consumed by |
|---|---|---|
| `bin/pwn_<name>` | template above | shell / CI |
| `~/.pwn/skills/<name>/SKILL.md` | `learning_distill_skill` | every future pwn-ai prompt |
| `cron` job | `cron_create(ruby: '...')` | system crontab → unattended |

**See also:** [CLI Drivers](CLI-Drivers.md) · [Cron](Cron.md) ·
[Skills, Memory & Learning](Skills-Memory-Learning.md)

[← Home](Home.md)