pwn 0.5.710 → 0.5.712

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb2089e549bccd1c21a643fd22719f13cb3a7519c1580f9cbd3e425c66f2be91
-  data.tar.gz: d27e48a928750b279f8315e8a578071bed21403728ae7f8c5474015f75ff557e
+  metadata.gz: 24bf2b4c619ee3d57fe991bff09ab97838506283144fbcde635d39c7e368a3b1
+  data.tar.gz: 1ed8d4f63cfc8331fd494172e65724037131a378cd42716df2d36e22dfdce6d5
 SHA512:
-  metadata.gz: 37c74e1e2ab80b6a872f0d533ec402b520bffd70dc1198114574b3bbe90383c9dbebe6ac9b844e79023eed1cdeefc6cb8df4cca964b186cff1e25bc718384b12
-  data.tar.gz: 703c871173f4a754b9a515b45c4fd6aa4d3e2b1590f397168a53869d7eed5a77243a69e635f3894ce61be401b4c260395b0be7b435d6dc0613067b7b9047345c
+  metadata.gz: d8ce0b58ac26c52adacedd0ae58df169357d87d53f1e5040d9c6eba4083bf83545065c8e504a6f2e7baebb84409b807af99fa6ef2cfd148682e898962794b67e
+  data.tar.gz: 712a254b7346e7eb3668634c1b47bf336dce6393e960ad1ed24e0d0abc812752ed1cd442f277c44bd6b1c3360472b8d44075418758909fd7bbf435ea2d8ebe2f

data/documentation/Installation.md

@@ -103,10 +103,14 @@ pwn setup --list-profiles
 `--deps` / `--profile` will:
 
 1. Resolve the profile → set of native gems + external binaries.
-2. Map those to OS packages for **your** package manager (data lives in
-   `PWN::Setup::NATIVE_GEMS` / `::TOOLCHAIN` - versioned with the gem, so
-   `gem install --verbose pwn`, git checkout, Docker, Packer and Vagrant all read the
-   same table).
+2. Map those to OS packages for **this** distro and version
+   (`PWN::Plugins::DetectOS.distro` / `.version`, e.g. Kali `2026.3` vs Ubuntu
+   `24.04`) via `PWN::Setup.packages_for`. Family fallbacks still live in
+   `PWN::Setup::NATIVE_GEMS` / `::TOOLCHAIN`. Tools with no OS package on this
+   distro (Frida, one_gadget, ROPgadget, checksec, ropper, kube-hunter, or
+   Kali-only names on Ubuntu) install via `pipx` (Debian/Kali/Ubuntu) or `pip`
+   / `gem`, or are skipped so one missing apt name cannot abort the whole
+   profile. Each OS package is installed in its own `apt-get`/`dnf`/… command.
 3. Show the exact commands, prompt (unless `--yes`), run them, then
    `gem pristine` / `gem install` any native extension that still fails to
    load, and re-run the doctor.

data/etc/default_skills/pwn/plugins/detect_os/SKILL.md

@@ -12,7 +12,7 @@ metadata:
 
 # PWN::Plugins::DetectOS
 
-This plugin converts images to readable text
+Detect host OS family, distro flavor, and version string.
 
 ## When to use
 
@@ -36,6 +36,8 @@ PWN::Plugins::DetectOS.type(opts)
 - `type`
 - `arch`
 - `endian`
+- `distro`
+- `version`
 - `authors`
 - `help`
 

data/etc/default_skills/pwn/setup/SKILL.md

@@ -28,11 +28,12 @@ Class methods take `(opts = {})` and read `opts`.
 
 ```ruby
 PWN::Setup.help
-PWN::Setup.pkg_manager(opts)
+PWN::Setup.packages_for(opts)
 ```
 
 ## Public methods
 
+- `packages_for`
 - `pkg_manager`
 - `check`
 - `deps`
@@ -43,11 +44,15 @@ PWN::Setup.pkg_manager(opts)
 - `authors`
 - `help`
 
+## References
+
+- `references/urls.md` — URLs from source
+
 ## Source
 
 `pwn/setup.rb`
 
 ## Verification
 
-`PWN::Setup.respond_to?(:pkg_manager)` after the
+`PWN::Setup.respond_to?(:packages_for)` after the
 module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/setup/references/urls.md

@@ -0,0 +1,3 @@
+# PWN::Setup source links
+
+- https://install.pwndbg.re

data/lib/pwn/plugins/credential_attack.rb

@@ -10,7 +10,7 @@ module PWN
       WORDLISTS = File.join(Dir.home, '.pwn', 'wordlists')
 
       public_class_method def self.required_bins
-        []
+        %w[hydra john hashcat medusa]
       end
 
       public_class_method def self.wordlist_dir(opts = {})

data/lib/pwn/plugins/detect_os.rb

@@ -4,10 +4,28 @@ require 'os'
 
 module PWN
   module Plugins
-    # This plugin converts images to readable text
+    # Detect host OS family, distro flavor, and version string.
     module DetectOS
-      # Supported Method Parameters::
-      # PWN::Plugins::DetectOS.type
+      ID_ALIASES = {
+        'chromiumos' => :chromeos,
+        'chromeos' => :chromeos,
+        'pop_os' => :pop,
+        'pop' => :pop,
+        'ol' => :oracle,
+        'opensuse-leap' => :opensuse,
+        'opensuse-tumbleweed' => :opensuse,
+        'sles' => :suse,
+        'darwin' => :macos,
+        'osx' => :macos,
+        'macos' => :macos,
+        'iphoneos' => :ios,
+        'ipados' => :ios,
+        'ios' => :ios,
+        'win32' => :windows,
+        'mingw32' => :windows,
+        'mingw' => :windows,
+        'mswin' => :windows
+      }.freeze
 
       public_class_method def self.type
         os = :cygwin if OS.cygwin?
@@ -23,18 +41,12 @@ module PWN
         raise e
       end
 
-      # Supported Method Parameters::
-      # PWN::Plugins::DetectOS.arch
-
       public_class_method def self.arch
         OS.host_cpu
       rescue StandardError => e
         raise e
       end
 
-      # Supported Method Parameters::
-      # PWN::Plugins::DetectOS.endian
-
       public_class_method def self.endian
         if [1].pack('I') == [1].pack('N')
           :big
@@ -45,7 +57,99 @@ module PWN
         raise e
       end
 
-      # Author(s):: 0day Inc. <support@0dayinc.com>
+      # Supported Method Parameters::
+      # PWN::Plugins::DetectOS.distro(
+      #   os_release: 'optional - /etc/os-release body (defaults to reading the file)',
+      #   lsb_release: 'optional - /etc/lsb-release body',
+      #   build_prop: 'optional - Android /system/build.prop body',
+      #   type: 'optional - OS family from #type (e.g. :linux :osx :windows :freebsd)',
+      #   platform: 'optional - RUBY_PLATFORM override',
+      #   uname: 'optional - uname -s string',
+      #   sw_vers: 'optional - macOS/iOS product version string',
+      #   win_ver: 'optional - Windows ver command output'
+      # )
+
+      public_class_method def self.distro(opts = {})
+        return normalize_id(id: opts[:distro]) if opts[:distro]
+
+        platform = (opts[:platform] || RUBY_PLATFORM).to_s.downcase
+        uname = (opts[:uname] || live_uname_s).to_s.downcase
+        os_type = opts[:type] || type
+        osr = parse_kv(content: opts[:os_release] || read_if_present(path: '/etc/os-release') || read_if_present(path: '/usr/lib/os-release'))
+        lsb = parse_kv(content: opts[:lsb_release] || read_if_present(path: '/etc/lsb-release'))
+        prop = parse_kv(content: opts[:build_prop] || read_if_present(path: '/system/build.prop'))
+
+        return :ios if ios_host?(platform: platform, uname: uname)
+        return :android if android_host?(osr: osr, prop: prop, uname: uname)
+        return :chromeos if chromeos_host?(osr: osr, lsb: lsb)
+        return :macos if os_type == :osx || platform.include?('darwin')
+        return :windows if os_type == :windows || platform.match?(/mswin|mingw|cygwin/)
+        return :freebsd if os_type == :freebsd || uname.include?('freebsd')
+        return :openbsd if os_type == :openbsd || uname.include?('openbsd')
+        return :netbsd if os_type == :netbsd || uname.include?('netbsd')
+        return :dragonfly if uname.include?('dragonfly')
+        return :cygwin if os_type == :cygwin
+
+        id = osr['ID'].to_s
+        return normalize_id(id: id) unless id.empty?
+
+        like = osr['ID_LIKE'].to_s.downcase
+        return :debian if like.include?('debian')
+        return :fedora if like.include?('fedora') || like.include?('rhel')
+        return :arch if like.include?('arch')
+        return :suse if like.include?('suse')
+
+        os_type || :unknown
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::DetectOS.version(
+      #   os_release: 'optional - /etc/os-release body',
+      #   lsb_release: 'optional - /etc/lsb-release body',
+      #   build_prop: 'optional - Android build.prop body',
+      #   sw_vers: 'optional - macOS/iOS product version',
+      #   win_ver: 'optional - Windows ver output',
+      #   uname_r: 'optional - uname -r string',
+      #   type: 'optional - OS family from #type'
+      # )
+
+      public_class_method def self.version(opts = {})
+        return opts[:version].to_s if opts[:version]
+
+        injected = %i[os_release lsb_release build_prop sw_vers win_ver uname_r].any? { |k| opts.key?(k) }
+        os_type = opts[:type] || type
+        osr = parse_kv(content: opts[:os_release] || (injected ? nil : read_if_present(path: '/etc/os-release') || read_if_present(path: '/usr/lib/os-release')))
+        lsb = parse_kv(content: opts[:lsb_release] || (injected ? nil : read_if_present(path: '/etc/lsb-release')))
+        prop = parse_kv(content: opts[:build_prop] || (injected ? nil : read_if_present(path: '/system/build.prop')))
+
+        from_osr = osr['VERSION_ID'].to_s
+        return from_osr unless from_osr.empty?
+
+        chrome = lsb['CHROMEOS_RELEASE_VERSION'].to_s
+        return chrome unless chrome.empty?
+
+        android = prop['ro.build.version.release'].to_s
+        return android unless android.empty?
+
+        if os_type == :osx || opts[:sw_vers]
+          mac = (opts[:sw_vers] || live_sw_vers).to_s.strip
+          return mac unless mac.empty?
+        end
+
+        if os_type == :windows || opts[:win_ver]
+          win = (opts[:win_ver] || live_win_ver).to_s
+          m = win.match(/\[Version\s+([^\]]+)\]/i) || win.match(/(\d+\.\d+(?:\.\d+)*)/)
+          return m[1] if m
+        end
+
+        rel = (opts[:uname_r] || live_uname_r).to_s.strip
+        return rel if %i[freebsd openbsd netbsd].include?(os_type) && !rel.empty?
+
+        debian = read_if_present(path: '/etc/debian_version').to_s.strip
+        return debian unless debian.empty?
+
+        osr['VERSION'].to_s
+      end
 
       public_class_method def self.authors
         "AUTHOR(S):
@@ -53,24 +157,129 @@ module PWN
         "
       end
 
-      # Display Usage for this Module
-
       public_class_method def self.help
         puts "USAGE:
-          # Run type and return its result
+          # Return the OS family as a symbol (:linux :osx :windows :freebsd :openbsd :netbsd :cygwin).
           #{self}.type
 
-          # Run arch and return its result
+          # Return the CPU architecture string from the host (e.g. x86_64, arm64).
           #{self}.arch
 
-          # Run endian and return its result
+          # Return CPU endianness as :little or :big.
           #{self}.endian
 
+          # Return the distro flavor as a lowercase symbol (:kali :ubuntu :macos :windows :freebsd …).
+          #{self}.distro(
+            os_release: 'optional - /etc/os-release body (defaults to reading the file)',
+            lsb_release: 'optional - /etc/lsb-release body',
+            build_prop: 'optional - Android /system/build.prop body',
+            type: 'optional - OS family from #type (e.g. :linux :osx :windows :freebsd)',
+            platform: 'optional - RUBY_PLATFORM override (detect iOS/Android/Windows)',
+            uname: 'optional - uname -s string',
+            sw_vers: 'optional - macOS/iOS product version string',
+            win_ver: 'optional - Windows ver command output',
+            distro: 'optional - force a distro id instead of detecting'
+          )
+
+          # Return the distro version as a string (e.g. 2026.3, 24.04, 15.1, 14.1-RELEASE).
+          #{self}.version(
+            os_release: 'optional - /etc/os-release body',
+            lsb_release: 'optional - /etc/lsb-release body',
+            build_prop: 'optional - Android build.prop body',
+            sw_vers: 'optional - macOS/iOS product version',
+            win_ver: 'optional - Windows ver output',
+            uname_r: 'optional - uname -r string',
+            type: 'optional - OS family from #type',
+            version: 'optional - force a version string instead of detecting'
+          )
+
           # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
         constants.sort
       end
+
+      private_class_method def self.normalize_id(opts = {})
+        raw = opts[:id].to_s.downcase.strip.gsub(/["']/, '')
+        return :unknown if raw.empty?
+
+        ID_ALIASES[raw] || raw.tr('-', '_').to_sym
+      end
+
+      private_class_method def self.parse_kv(opts = {})
+        content = opts[:content].to_s
+        return {} if content.empty?
+
+        content.each_line.with_object({}) do |line, acc|
+          next if line.strip.empty? || line.strip.start_with?('#')
+
+          key, val = line.split('=', 2)
+          next unless val
+
+          acc[key.strip] = val.strip.gsub(/\A["']|["']\z/, '')
+        end
+      end
+
+      private_class_method def self.read_if_present(opts = {})
+        path = opts[:path].to_s
+        return unless File.readable?(path)
+
+        File.read(path)
+      rescue StandardError
+        nil
+      end
+
+      private_class_method def self.ios_host?(opts = {})
+        blob = "#{opts[:platform]} #{opts[:uname]}"
+        blob.match?(/iphone|ipad|ios/)
+      end
+
+      private_class_method def self.android_host?(opts = {})
+        osr = opts[:osr] || {}
+        prop = opts[:prop] || {}
+        uname = opts[:uname].to_s
+        osr['ID'].to_s.downcase == 'android' ||
+          !prop['ro.build.version.release'].to_s.empty? ||
+          uname.include?('android') ||
+          File.exist?('/system/build.prop')
+      end
+
+      private_class_method def self.chromeos_host?(opts = {})
+        osr = opts[:osr] || {}
+        lsb = opts[:lsb] || {}
+        id = osr['ID'].to_s.downcase
+        id == 'chromeos' || id == 'chromiumos' ||
+          !lsb['CHROMEOS_RELEASE_NAME'].to_s.empty? ||
+          !lsb['CHROMEOS_RELEASE_VERSION'].to_s.empty?
+      end
+
+      private_class_method def self.live_uname_s(opts = {})
+        opts[:skip]
+        `uname -s 2>/dev/null`.to_s
+      rescue StandardError
+        ''
+      end
+
+      private_class_method def self.live_uname_r(opts = {})
+        opts[:skip]
+        `uname -r 2>/dev/null`.to_s
+      rescue StandardError
+        ''
+      end
+
+      private_class_method def self.live_sw_vers(opts = {})
+        opts[:skip]
+        `sw_vers -productVersion 2>/dev/null`.to_s
+      rescue StandardError
+        ''
+      end
+
+      private_class_method def self.live_win_ver(opts = {})
+        opts[:skip]
+        `ver 2>NUL`.to_s
+      rescue StandardError
+        ''
+      end
     end
   end
 end

data/lib/pwn/plugins/preflight_checker.rb

@@ -23,7 +23,11 @@ module PWN
         'PWN::Plugins::BurpSuite' => { bins: %w[burpsuite] },
         'PWN::Plugins::Zaproxy' => { bins: %w[zaproxy] },
         'PWN::Plugins::Packet' => { bins: [], caps: %w[CAP_NET_RAW] },
-        'PWN::Plugins::K8s' => { bins: %w[trivy], services: [{ name: 'docker', path: '/var/run/docker.sock' }] }
+        'PWN::Plugins::K8s' => { bins: %w[trivy], services: [{ name: 'docker', path: '/var/run/docker.sock' }] },
+        'PWN::Plugins::Semgrep' => { bins: %w[semgrep] },
+        'PWN::Plugins::ExploitDB' => { bins: %w[searchsploit] },
+        'PWN::Plugins::Recon' => { bins: %w[subfinder httpx] },
+        'PWN::Plugins::CredentialAttack' => { bins: %w[hydra john hashcat] }
       }.freeze
 
       public_class_method def self.required_bins

data/lib/pwn/plugins/recon.rb

@@ -13,7 +13,7 @@ module PWN
       UA = 'pwn-recon/1.0'
 
       public_class_method def self.required_bins
-        []
+        %w[subfinder httpx masscan amass]
       end
 
       public_class_method def self.subdomains(opts = {})

data/lib/pwn/setup.rb

@@ -160,7 +160,7 @@ module PWN
       },
       'sqlmap' => {
         apt: %w[sqlmap], dnf: %w[sqlmap], pacman: %w[sqlmap], brew: %w[sqlmap], port: %w[],
-        plugins: %w[PWN::Plugins::Fuzz]
+        plugins: %w[PWN::Plugins::Sqlmap PWN::Plugins::Fuzz]
       },
       'tor' => {
         apt: %w[tor], dnf: %w[tor], pacman: %w[tor], brew: %w[tor], port: %w[tor],
@@ -246,23 +246,28 @@ module PWN
         plugins: %w[PWN::Plugins::Radare2]
       },
       'checksec' => {
-        apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        apt: %w[], dnf: %w[], pacman: %w[checksec], brew: %w[], port: %w[],
+        pip: 'checksec.py',
         plugins: %w[PWN::Plugins::GDB PWN::Plugins::ExploitDev]
       },
       'ROPgadget' => {
         apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        pip: 'ROPGadget',
         plugins: %w[PWN::Plugins::ExploitDev]
       },
       'one_gadget' => {
         apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        gem: 'one_gadget',
         plugins: %w[PWN::Plugins::ExploitDev]
       },
       'pwndbg' => {
         apt: %w[pwndbg], dnf: %w[], pacman: %w[pwndbg], brew: %w[], port: %w[],
+        script: "curl --proto '=https' --tlsv1.2 -LsSf 'https://install.pwndbg.re' | sh -s -- -t pwndbg-gdb",
         plugins: %w[PWN::Plugins::GDB]
       },
       'ropper' => {
         apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        pip: 'ropper',
         plugins: %w[PWN::Plugins::ExploitDev]
       },
       'rizin' => {
@@ -280,6 +285,7 @@ module PWN
       },
       'frida' => {
         apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        pip: 'frida-tools',
         plugins: %w[PWN::Plugins::Frida]
       },
       'apktool' => {
@@ -297,8 +303,90 @@ module PWN
       'hydra' => {
         apt: %w[hydra], dnf: %w[hydra], pacman: %w[hydra], brew: %w[thc-hydra], port: %w[],
         plugins: %w[PWN::Plugins::CredentialAttack]
+      },
+      'afl-fuzz' => {
+        apt: %w[afl++], dnf: %w[afl++], pacman: %w[afl++], brew: %w[afl++], port: %w[],
+        plugins: %w[PWN::Plugins::AFLplusplus]
+      },
+      'searchsploit' => {
+        apt: %w[exploitdb], dnf: %w[], pacman: %w[exploitdb], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::ExploitDB]
+      },
+      'trivy' => {
+        apt: %w[trivy], dnf: %w[trivy], pacman: %w[trivy], brew: %w[trivy], port: %w[],
+        plugins: %w[PWN::Plugins::K8s]
+      },
+      'kube-hunter' => {
+        apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        pip: 'kube-hunter',
+        plugins: %w[PWN::Plugins::K8s]
+      },
+      'semgrep' => {
+        apt: %w[semgrep], dnf: %w[], pacman: %w[], brew: %w[semgrep], port: %w[],
+        pip: 'semgrep',
+        plugins: %w[PWN::Plugins::Semgrep]
+      },
+      'vol' => {
+        apt: %w[volatility3], dnf: %w[], pacman: %w[volatility3], brew: %w[], port: %w[],
+        pip: 'volatility3',
+        plugins: %w[PWN::Plugins::Volatility]
+      },
+      'subfinder' => {
+        apt: %w[subfinder], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::Recon]
+      },
+      'httpx' => {
+        apt: %w[httpx-toolkit], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::Recon]
+      },
+      'masscan' => {
+        apt: %w[masscan], dnf: %w[masscan], pacman: %w[masscan], brew: %w[masscan], port: %w[],
+        plugins: %w[PWN::Plugins::Recon]
+      },
+      'naabu' => {
+        apt: %w[naabu], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::Recon]
+      },
+      'amass' => {
+        apt: %w[amass], dnf: %w[], pacman: %w[], brew: %w[amass], port: %w[],
+        plugins: %w[PWN::Plugins::Recon]
+      },
+      'john' => {
+        apt: %w[john], dnf: %w[john], pacman: %w[john], brew: %w[john], port: %w[john],
+        plugins: %w[PWN::Plugins::CredentialAttack]
+      },
+      'hashcat' => {
+        apt: %w[hashcat], dnf: %w[hashcat], pacman: %w[hashcat], brew: %w[hashcat], port: %w[],
+        plugins: %w[PWN::Plugins::CredentialAttack]
+      },
+      'medusa' => {
+        apt: %w[medusa], dnf: %w[medusa], pacman: %w[medusa], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::CredentialAttack]
+      },
+      'hashid' => {
+        apt: %w[hashid], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        pip: 'hashid',
+        plugins: %w[PWN::Plugins::CredentialAttack]
       }
-    }.freeze
+    }.tap do |t|
+      %w[burpsuite zaproxy msfconsole nuclei searchsploit httpx subfinder naabu amass apktool jadx rizin pwndbg trivy semgrep vol hashid].each do |bin|
+        next unless t[bin]
+
+        t[bin] = t[bin].merge(ubuntu: [], debian: [])
+      end
+      {
+        'checksec' => %w[checksec],
+        'ROPgadget' => %w[python3-ropgadget],
+        'ropper' => %w[ropper],
+        'pwndbg' => [],
+        'semgrep' => [],
+        'vol' => []
+      }.each do |bin, pkgs|
+        next unless t[bin]
+
+        t[bin] = t[bin].merge(kali: pkgs)
+      end
+    end.freeze
 
     # Capability profiles — how you get the ergonomics of `pwn-full`
     # without shipping a second gem. `pwn setup --profile <name>`.
@@ -368,6 +456,27 @@ module PWN
     OK   = "\e[32mok\e[0m"
     MISS = "\e[31mMISSING\e[0m"
 
+    # Supported Method Parameters::
+    # PWN::Setup.packages_for(
+    #   bin: 'required - TOOLCHAIN key (e.g. nmap or burpsuite)',
+    #   distro: 'optional - DetectOS.distro symbol (defaults to live detect)',
+    #   version: 'optional - DetectOS.version string (defaults to live detect)',
+    #   pm_key: 'optional - package-manager family (:apt :dnf :pacman :brew :port :pkg …)'
+    # )
+
+    public_class_method def self.packages_for(opts = {})
+      bin = opts[:bin].to_s
+      meta = TOOLCHAIN[bin] || {}
+      distro = (opts[:distro] || PWN::Plugins::DetectOS.distro).to_s.to_sym
+      version = (opts[:version] || PWN::Plugins::DetectOS.version).to_s
+      pm_key = opts[:pm_key] || pkg_manager[:key]
+      ver_key = :"#{distro}/#{version}"
+      return Array(meta[ver_key]) if meta.key?(ver_key)
+      return Array(meta[distro]) if meta.key?(distro)
+
+      Array(meta[pm_key])
+    end
+
     # Supported Method Parameters::
     # PWN::Setup.pkg_manager
 
@@ -385,13 +494,39 @@ module PWN
       end
       sudo = root || !bin?(name: 'sudo') ? '' : 'sudo '
 
+      distro = begin
+        PWN::Plugins::DetectOS.distro
+      rescue StandardError
+        nil
+      end
+
       @pkg_manager =
-        if bin?(name: 'apt-get')     then { key: :apt,    install: "#{sudo}apt-get install -y",    sudo: !sudo.empty? }
-        elsif bin?(name: 'dnf')      then { key: :dnf,    install: "#{sudo}dnf install -y",        sudo: !sudo.empty? }
-        elsif bin?(name: 'pacman')   then { key: :pacman, install: "#{sudo}pacman -S --noconfirm", sudo: !sudo.empty? }
-        elsif bin?(name: 'brew')     then { key: :brew,   install: 'brew install',                 sudo: false        }
-        elsif bin?(name: 'port')     then { key: :port,   install: "#{sudo}port -N install",       sudo: !sudo.empty? }
-        else { key: :unknown, install: nil, sudo: false }
+        if distro == :freebsd && bin?(name: 'pkg')
+          { key: :pkg, install: "#{sudo}pkg install -y", sudo: !sudo.empty? }
+        elsif distro == :openbsd && bin?(name: 'pkg_add')
+          { key: :pkg_add, install: "#{sudo}pkg_add", sudo: !sudo.empty? }
+        elsif distro == :netbsd && bin?(name: 'pkgin')
+          { key: :pkgin, install: "#{sudo}pkgin -y install", sudo: !sudo.empty? }
+        elsif distro == :alpine && bin?(name: 'apk')
+          { key: :apk, install: "#{sudo}apk add", sudo: !sudo.empty? }
+        elsif distro == :android && bin?(name: 'pkg')
+          { key: :pkg, install: 'pkg install -y', sudo: false }
+        elsif distro == :windows && bin?(name: 'winget')
+          { key: :winget, install: 'winget install -e --accept-package-agreements --accept-source-agreements', sudo: false }
+        elsif distro == :windows && bin?(name: 'choco')
+          { key: :choco, install: 'choco install -y', sudo: false }
+        elsif bin?(name: 'apt-get')
+          { key: :apt, install: "#{sudo}apt-get install -y", sudo: !sudo.empty? }
+        elsif bin?(name: 'dnf')
+          { key: :dnf, install: "#{sudo}dnf install -y", sudo: !sudo.empty? }
+        elsif bin?(name: 'pacman')
+          { key: :pacman, install: "#{sudo}pacman -S --noconfirm", sudo: !sudo.empty? }
+        elsif bin?(name: 'brew')
+          { key: :brew, install: 'brew install', sudo: false }
+        elsif bin?(name: 'port')
+          { key: :port, install: "#{sudo}port -N install", sudo: !sudo.empty? }
+        else
+          { key: :unknown, install: nil, sudo: false }
         end
     end
 
@@ -506,12 +641,14 @@ module PWN
       profile = (opts[:profile] || :full).to_sym
       yes     = opts[:yes] ? true : false
       dry_run = opts[:dry_run] ? true : false
+      distro  = opts[:distro] || PWN::Plugins::DetectOS.distro
+      version = opts[:version] || PWN::Plugins::DetectOS.version
       io      = opts[:io] || $stdout
 
       raise "Unknown profile '#{profile}'. Known: #{PROFILES.keys.join(', ')}" unless PROFILES.key?(profile)
 
       pm = pkg_manager
-      raise 'No supported package manager found (apt / dnf / pacman / brew / port).' if pm[:key] == :unknown
+      raise 'No supported package manager found (apt / dnf / pacman / brew / port / pkg / winget / choco).' if pm[:key] == :unknown
 
       prof     = PROFILES[profile]
       gems     = Array(prof[:gems])
@@ -527,22 +664,25 @@ module PWN
       bins     = Array(prof[:bins])
       os_pkgs  = []
       gems.each { |g| os_pkgs.concat(Array(NATIVE_GEMS.dig(g, pm[:key]))) }
-      bins.each { |b| os_pkgs.concat(Array(TOOLCHAIN.dig(b, pm[:key]))) }
+      bins.each { |b| os_pkgs.concat(packages_for(bin: b, distro: distro, version: version, pm_key: pm[:key])) }
       os_pkgs = os_pkgs.reject(&:empty?).uniq
+      alts = alt_install_cmds(bins: bins, pm_key: pm[:key], distro: distro, version: version)
+      os_pkgs = (['pipx'] + os_pkgs).uniq if pm[:key] == :apt && alts.any? { |c| c.include?('pipx install') }
 
       io.puts "Profile   : #{profile} — #{prof[:desc]}"
+      io.puts "Distro    : #{distro} #{version}"
       io.puts "Pkg mgr   : #{pm[:key]}"
       io.puts "OS pkgs   : #{os_pkgs.empty? ? '(none)' : os_pkgs.join(' ')}"
       io.puts "Ruby exts : #{gems.empty? ? '(none)' : gems.join(' ')}"
       io.puts
 
-      cmds = []
-      cmds << "#{pm[:install]} #{os_pkgs.map { |p| Shellwords.escape(p) }.join(' ')}" unless os_pkgs.empty?
+      cmds = os_pkgs.map { |pkg| "#{pm[:install]} #{Shellwords.escape(pkg)}" }
       unless gems.empty?
         broken = gems.reject { |g| gem_loadable?(name: g) }
         cmds << "gem pristine #{broken.map { |g| Shellwords.escape(g) }.join(' ')}" unless broken.empty?
         cmds << "gem install #{broken.map { |g| Shellwords.escape(g) }.join(' ')}"  unless broken.empty?
       end
+      cmds.concat(alts)
 
       if cmds.empty?
         io.puts "Nothing to do — profile '#{profile}' is already satisfied."
@@ -786,6 +926,35 @@ module PWN
       false
     end
 
+    private_class_method def self.alt_install_cmds(opts = {})
+      bins = Array(opts[:bins])
+      pm_key = opts[:pm_key]
+      distro = opts[:distro]
+      version = opts[:version]
+      bins.filter_map do |b|
+        meta = TOOLCHAIN[b] || {}
+        next if packages_for(bin: b, pm_key: pm_key, distro: distro, version: version).any?
+
+        if meta[:pip].to_s != ''
+          pip_install_cmd(pkg: meta[:pip], distro: distro)
+        elsif meta[:gem].to_s != ''
+          "gem install #{Shellwords.escape(meta[:gem])}"
+        elsif meta[:script].to_s != ''
+          meta[:script].to_s
+        end
+      end
+    end
+
+    private_class_method def self.pip_install_cmd(opts = {})
+      pkg = opts[:pkg].to_s
+      distro = opts[:distro].to_s.to_sym
+      if %i[kali debian ubuntu mint pop chromeos].include?(distro)
+        "pipx install #{Shellwords.escape(pkg)}"
+      else
+        "python3 -m pip install --user #{Shellwords.escape(pkg)}"
+      end
+    end
+
     private_class_method def self.bin?(opts = {})
       !which(name: opts[:name]).empty?
     end
@@ -935,21 +1104,31 @@ module PWN
 
     public_class_method def self.help
       puts "USAGE:
-        # Run pkg manager and return its result
+        # Detect this host's package manager (apt, dnf, pacman, brew, pkg, winget, …).
         #{self}.pkg_manager
 
+        # Resolve OS package names for a TOOLCHAIN binary on this distro/version.
+        #{self}.packages_for(
+          bin: 'required - TOOLCHAIN key (e.g. nmap or burpsuite)',
+          distro: 'optional - DetectOS.distro symbol (defaults to live detect)',
+          version: 'optional - DetectOS.version string (defaults to live detect)',
+          pm_key: 'optional - package-manager family (:apt :dnf :pacman :brew :port :pkg)'
+        )
+
         # Run check and return its result
         #{self}.check(
           io: 'optional - IO to write the report to (default $stdout)',
           profile: 'optional - profile value consumed by #check'
         )
 
-        # Run deps and return its result
+        # Install OS packages + native gems for a capability profile.
         #{self}.deps(
           profile: 'optional - one of PROFILES.keys (default :full)',
           yes: 'optional - non-interactive; assume yes to prompts (default false)',
           dry_run: 'optional - print commands only, do not execute (default false)',
-          io: 'optional - IO to write to (default $stdout)'
+          io: 'optional - IO to write to (default $stdout)',
+          distro: 'optional - DetectOS.distro override (e.g. :kali :ubuntu :macos)',
+          version: 'optional - DetectOS.version override (e.g. 2026.3 or 24.04)'
         )
 
         # Opt-in installer for SHIFT+ENTER multi-line support in the pwn-ai /

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.710'
+  VERSION = '0.5.712'
 end

data/spec/documentation/installation_md_spec.rb

@@ -146,7 +146,7 @@ RSpec.describe 'documentation/Installation.md' do
       pm   = PWN::Setup.pkg_manager[:key]
       # every :net bin's package appears in the plan
       PWN::Setup::PROFILES[:net][:bins].each do |b|
-        Array(PWN::Setup::TOOLCHAIN.dig(b, pm)).each do |pkg|
+        Array(PWN::Setup.packages_for(bin: b, pm_key: pm)).each do |pkg|
           expect(plan).to include(pkg), "profile :net missing own package '#{pkg}'"
         end
       end

data/spec/lib/pwn/plugins/detect_os_spec.rb

@@ -4,12 +4,62 @@ require 'spec_helper'
 
 describe PWN::Plugins::DetectOS do
   it 'should display information for authors' do
-    authors_response = PWN::Plugins::DetectOS
-    expect(authors_response).to respond_to :authors
+    expect(described_class).to respond_to :authors
   end
 
   it 'should display information for existing help method' do
-    help_response = PWN::Plugins::DetectOS
-    expect(help_response).to respond_to :help
+    expect(described_class).to respond_to :help
+  end
+
+  describe '.distro' do
+    it 'returns a lowercase symbol on this host' do
+      expect(described_class.distro).to be_a(Symbol)
+    end
+
+    it 'reads Kali from os-release including rolling versions like 2026.3' do
+      body = <<~OS
+        ID=kali
+        VERSION_ID="2026.3"
+        ID_LIKE=debian
+      OS
+      expect(described_class.distro(os_release: body, type: :linux)).to eq(:kali)
+      expect(described_class.version(os_release: body, type: :linux)).to eq('2026.3')
+    end
+
+    it 'reads Ubuntu and Debian' do
+      expect(described_class.distro(os_release: "ID=ubuntu\nVERSION_ID=\"24.04\"\n", type: :linux)).to eq(:ubuntu)
+      expect(described_class.version(os_release: "ID=ubuntu\nVERSION_ID=\"24.04\"\n", type: :linux)).to eq('24.04')
+      expect(described_class.distro(os_release: "ID=debian\nVERSION_ID=\"12\"\n", type: :linux)).to eq(:debian)
+    end
+
+    it 'reads Fedora, Arch, Alpine' do
+      expect(described_class.distro(os_release: "ID=fedora\nVERSION_ID=41\n", type: :linux)).to eq(:fedora)
+      expect(described_class.distro(os_release: "ID=arch\n", type: :linux)).to eq(:arch)
+      expect(described_class.distro(os_release: "ID=alpine\nVERSION_ID=3.20.0\n", type: :linux)).to eq(:alpine)
+    end
+
+    it 'detects ChromeOS from lsb-release' do
+      lsb = "CHROMEOS_RELEASE_NAME=Chrome OS\nCHROMEOS_RELEASE_VERSION=15662.64.0\n"
+      expect(described_class.distro(lsb_release: lsb, os_release: "ID=chromeos\n", type: :linux)).to eq(:chromeos)
+      expect(described_class.version(lsb_release: lsb, os_release: "ID=chromeos\n", type: :linux)).to eq('15662.64.0')
+    end
+
+    it 'detects Android from build.prop' do
+      prop = "ro.build.version.release=14\nro.product.brand=google\n"
+      expect(described_class.distro(build_prop: prop, type: :linux)).to eq(:android)
+      expect(described_class.version(build_prop: prop, type: :linux)).to eq('14')
+    end
+
+    it 'detects macOS, iOS, Windows, and BSDs' do
+      expect(described_class.distro(type: :osx, sw_vers: '15.1')).to eq(:macos)
+      expect(described_class.version(type: :osx, sw_vers: '15.1')).to eq('15.1')
+      expect(described_class.distro(type: :linux, platform: 'arm64-darwin-ios')).to eq(:ios)
+      expect(described_class.distro(type: :windows, win_ver: 'Microsoft Windows [Version 10.0.26100.1742]')).to eq(:windows)
+      expect(described_class.version(type: :windows, win_ver: 'Microsoft Windows [Version 10.0.26100.1742]')).to eq('10.0.26100.1742')
+      expect(described_class.distro(type: :freebsd, uname: 'FreeBSD')).to eq(:freebsd)
+      expect(described_class.version(type: :freebsd, uname_r: '14.1-RELEASE')).to eq('14.1-RELEASE')
+      expect(described_class.distro(type: :openbsd, uname: 'OpenBSD')).to eq(:openbsd)
+      expect(described_class.distro(type: :netbsd, uname: 'NetBSD')).to eq(:netbsd)
+    end
   end
 end

data/spec/lib/pwn/setup_spec.rb

@@ -101,4 +101,94 @@ describe PWN::Setup do
     expect(body.scan('PWN::Setup.ensure_cron').length).to eq(1)
     expect(body).to include('opts[:migrate] && running')
   end
+
+  it 'TOOLCHAIN covers every plugin required_bins name' do
+    plugin_bins = Dir[File.expand_path('../../../lib/pwn/plugins/*.rb', __dir__)].flat_map do |path|
+      src = File.read(path)
+      m = src.match(/public_class_method def self\.required_bins\n\s+%w\[([^\]]*)\]/)
+      next [] unless m
+
+      m[1].split
+    end.uniq
+    missing = plugin_bins - PWN::Setup::TOOLCHAIN.keys
+    expect(missing).to eq([]), "pwn setup TOOLCHAIN missing plugin bins: #{missing.join(', ')}"
+  end
+
+  it 'every TOOLCHAIN row has an OS package or pip/gem installer' do
+    PWN::Setup::TOOLCHAIN.each do |bin, meta|
+      has_pkg = %i[apt dnf pacman brew port].any? { |k| Array(meta[k]).any? }
+      has_alt = meta[:pip].to_s != '' || meta[:gem].to_s != '' || meta[:script].to_s != ''
+      expect(has_pkg || has_alt).to be(true), "#{bin} has no apt/dnf/pacman/brew/port/pip/gem installer"
+    end
+  end
+
+  it 'deps --profile full dry-run emits pipx/gem for bins with no distro package' do
+    io = StringIO.new
+    r = PWN::Setup.deps(profile: :full, dry_run: true, io: io)
+    cmds = Array(r[:ran]).map { |h| h[:cmd] }.join("\n")
+    expect(r[:skipped]).not_to be true
+    distro = PWN::Plugins::DetectOS.distro
+    version = PWN::Plugins::DetectOS.version
+    PWN::Setup::TOOLCHAIN.each do |bin, meta|
+      next if PWN::Setup.packages_for(bin: bin, distro: distro, version: version).any?
+
+      token = meta[:pip] || meta[:gem]
+      next unless token
+
+      expect(cmds).to include(token.to_s), "full dry-run missing installer for #{bin} (#{token})"
+    end
+  end
+
+  it 'packages_for prefers distro overrides then package-manager family' do
+    expect(
+      PWN::Setup.packages_for(bin: 'nmap', distro: :ubuntu, version: '24.04', pm_key: :apt)
+    ).to eq(%w[nmap])
+    expect(
+      PWN::Setup.packages_for(bin: 'burpsuite', distro: :kali, version: '2026.3', pm_key: :apt)
+    ).to eq(%w[burpsuite])
+    expect(
+      PWN::Setup.packages_for(bin: 'burpsuite', distro: :ubuntu, version: '24.04', pm_key: :apt)
+    ).to eq([])
+  end
+
+  it 'deps skips kali-only apt packages on ubuntu' do
+    io = StringIO.new
+    r = PWN::Setup.deps(profile: :web, dry_run: true, io: io, distro: :ubuntu, version: '24.04')
+    cmds = Array(r[:ran]).map { |h| h[:cmd] }.join(' ')
+    expect(cmds).not_to include('burpsuite')
+    expect(cmds).not_to include('zaproxy')
+  end
+
+  it 'maps Kali 2026.3 apt names for checksec ROPgadget ropper' do
+    k = { distro: :kali, version: '2026.3', pm_key: :apt }
+    expect(PWN::Setup.packages_for(k.merge(bin: 'checksec'))).to eq(%w[checksec])
+    expect(PWN::Setup.packages_for(k.merge(bin: 'ROPgadget'))).to eq(%w[python3-ropgadget])
+    expect(PWN::Setup.packages_for(k.merge(bin: 'ropper'))).to eq(%w[ropper])
+  end
+
+  it 'does not apt-get Kali-missing names and does not pip --user on Kali' do
+    k = { distro: :kali, version: '2026.3', pm_key: :apt }
+    %w[pwndbg semgrep vol].each do |b|
+      expect(PWN::Setup.packages_for(k.merge(bin: b))).to eq([])
+    end
+    r = PWN::Setup.deps(profile: :full, dry_run: true, io: StringIO.new, distro: :kali, version: '2026.3')
+    cmds = Array(r[:ran]).map { |h| h[:cmd] }
+    apt = cmds.select { |c| c.include?('apt-get') }.join("\n")
+    expect(apt).to include('checksec')
+    expect(apt).to include('python3-ropgadget')
+    expect(apt).to include('ropper')
+    expect(apt).not_to match(/\bpwndbg\b/)
+    expect(apt).not_to match(/\bsemgrep\b/)
+    expect(apt).not_to include('volatility3')
+    expect(cmds.join("\n")).not_to include('pip install --user')
+    expect(cmds.join("\n")).to include('install.pwndbg.re')
+    expect(cmds.join("\n")).to include('pwndbg-gdb')
+  end
+
+  it 'issues one apt-get per package so a missing name cannot abort the rest' do
+    r = PWN::Setup.deps(profile: :net, dry_run: true, io: StringIO.new, distro: :kali, version: '2026.3')
+    apt = Array(r[:ran]).map { |h| h[:cmd] }.select { |c| c.include?('apt-get install') }
+    expect(apt.length).to be > 1
+    apt.each { |c| expect(c).to match(/apt-get install -y \S+\z/) }
+  end
 end

data/third_party/pwn_rdoc.jsonl

@@ -1933,11 +1933,23 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::DefectDojo.tool_configuration_list Usage"},{"role":"assistant","content":"`PWN::Plugins::DefectDojo.tool_configuration_list`: Supported Method Parameters\n\ntool_configuration_list = PWN::Plugins::DefectDojo.tool_configuration_list(\n\ndd_obj: 'required dd_obj returned from #login method',\nid: 'optional - retrieve single test by id, otherwise return all'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::DefectDojo.tool_configuration_resource_uri_by_name Usage"},{"role":"assistant","content":"`PWN::Plugins::DefectDojo.tool_configuration_resource_uri_by_name`: Supported Method Parameters\n\ntool_configuration_resource_uri_by_name(\n\ndd_obj: 'required dd_obj returned from #login method',\ntool_config_name: 'required tool configuration name'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::DefectDojo.user_list Usage"},{"role":"assistant","content":"`PWN::Plugins::DefectDojo.user_list`: Supported Method Parameters\n\nuser_list = PWN::Plugins::DefectDojo.user_list(\n\ndd_obj: 'required dd_obj returned from #login method',\nid: 'optional - retrieve single user by id, otherwise return all'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.arch Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.arch`: Supported Method Parameters\n\nPWN::Plugins::DetectOS.arch\n"}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.endian Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.endian`: Supported Method Parameters\n\nPWN::Plugins::DetectOS.endian\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.android_host? Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.android_host?`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.arch Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.arch`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.authors`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.chromeos_host? Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.chromeos_host?`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.distro Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.distro`: Supported Method Parameters\n\nPWN::Plugins::DetectOS.distro(\n\nos_release: 'optional - /etc/os-release body (defaults to reading the file)',\nlsb_release: 'optional - /etc/lsb-release body',\nbuild_prop: 'optional - Android /system/build.prop body',\ntype: 'optional - OS family from #type (e.g. :linux :osx :windows :freebsd)',\nplatform: 'optional - RUBY_PLATFORM override',\nuname: 'optional - uname -s string',\nsw_vers: 'optional - macOS/iOS product version string',\nwin_ver: 'optional - Windows ver command output'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.endian Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.endian`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.help Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.help`: "}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.type Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.type`: Supported Method Parameters\n\nPWN::Plugins::DetectOS.type\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.ios_host? Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.ios_host?`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.live_sw_vers Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.live_sw_vers`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.live_uname_r Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.live_uname_r`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.live_uname_s Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.live_uname_s`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.live_win_ver Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.live_win_ver`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.normalize_id Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.normalize_id`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.parse_kv Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.parse_kv`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.read_if_present Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.read_if_present`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.type Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.type`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::DetectOS.version Usage"},{"role":"assistant","content":"`PWN::Plugins::DetectOS.version`: Supported Method Parameters\n\nPWN::Plugins::DetectOS.version(\n\nos_release: 'optional - /etc/os-release body',\nlsb_release: 'optional - /etc/lsb-release body',\nbuild_prop: 'optional - Android build.prop body',\nsw_vers: 'optional - macOS/iOS product version',\nwin_ver: 'optional - Windows ver output',\nuname_r: 'optional - uname -r string',\ntype: 'optional - OS family from #type'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::EIN.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::EIN.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::EIN.generate Usage"},{"role":"assistant","content":"`PWN::Plugins::EIN.generate`: Supported Method Parameters\n\nPWN::Plugins::EIN.generate(\n\ncount: 'required - number of EIN numbers to generate'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::EIN.help Usage"},{"role":"assistant","content":"`PWN::Plugins::EIN.help`: "}]}
@@ -3171,6 +3183,7 @@
 {"messages":[{"role":"user","content":"PWN::Sessions.to_response_history Usage"},{"role":"assistant","content":"`PWN::Sessions.to_response_history`: Supported Method Parameters\n\nhistory_for_ai = PWN::Sessions.to_response_history(session_id:) (converts transcript to the response_history format used by PWN::AI::* .chat)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.ai_active_engine Usage"},{"role":"assistant","content":"`PWN::Setup.ai_active_engine`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.ai_key_configured? Usage"},{"role":"assistant","content":"`PWN::Setup.ai_key_configured?`: "}]}
+{"messages":[{"role":"user","content":"PWN::Setup.alt_install_cmds Usage"},{"role":"assistant","content":"`PWN::Setup.alt_install_cmds`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.authors Usage"},{"role":"assistant","content":"`PWN::Setup.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.bin? Usage"},{"role":"assistant","content":"`PWN::Setup.bin?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.check Usage"},{"role":"assistant","content":"`PWN::Setup.check`: Supported Method Parameters\n\nPWN::Setup.check(\n\nio: 'optional - IO to write the report to (default $stdout)'\n\n)\n"}]}
@@ -3181,6 +3194,8 @@
 {"messages":[{"role":"user","content":"PWN::Setup.help Usage"},{"role":"assistant","content":"`PWN::Setup.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.list_profiles Usage"},{"role":"assistant","content":"`PWN::Setup.list_profiles`: Supported Method Parameters\n\nPWN::Setup.list_profiles(\n\nio: 'optional - IO to write to (default $stdout)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.migrate Usage"},{"role":"assistant","content":"`PWN::Setup.migrate`: Supported Method Parameters\n\nPWN::Setup.migrate(\n\nfix:     'optional - also autofix incompatible ~/.pwn files (default false)',\ndry_run: 'optional - print what WOULD happen (default false)',\nyes:     'optional - alias for fix:true (CI-friendly)',\nio:      'optional - IO to write to (default $stdout)'\n\n)\n\nDelegate to PWN::Migrate.run — verify every ~/.pwn state file is compatible with THIS pwn release and (optionally) autofix it.  A timestamped backup of ~/.pwn is taken first.  See ‘PWN::Migrate.help`.\n"}]}
+{"messages":[{"role":"user","content":"PWN::Setup.packages_for Usage"},{"role":"assistant","content":"`PWN::Setup.packages_for`: Supported Method Parameters\n\nPWN::Setup.packages_for(\n\nbin: 'required - TOOLCHAIN key (e.g. nmap or burpsuite)',\ndistro: 'optional - DetectOS.distro symbol (defaults to live detect)',\nversion: 'optional - DetectOS.version string (defaults to live detect)',\npm_key: 'optional - package-manager family (:apt :dnf :pacman :brew :port :pkg …)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Setup.pip_install_cmd Usage"},{"role":"assistant","content":"`PWN::Setup.pip_install_cmd`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.pkg_manager Usage"},{"role":"assistant","content":"`PWN::Setup.pkg_manager`: Supported Method Parameters\n\nPWN::Setup.pkg_manager\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.terminal Usage"},{"role":"assistant","content":"`PWN::Setup.terminal`: Supported Method Parameters\n\nPWN::Setup.terminal(\n\nyes:     'optional - assume yes; non-interactive (default false)',\ndry_run: 'optional - print what WOULD happen (default false)',\nio:      'optional - IO to write to (default $stdout)'\n\n)\n\nOpt-in installer for SHIFT+ENTER multi-line support in the pwn-ai / pwn-asm REPL. Never runs implicitly — the user invokes it with ‘pwn setup –terminal` after PWNMultiLineInput#ensure_vte_shift_enter tells them their emulator can’t distinguish Shift+Enter from Enter.\n\nWhat it does:\n\n1. Prints the two `~/.tmux.conf` lines that persist the runtime\n   `tmux set -s` calls PWNMultiLineInput already makes.\n2. If running under Terminator (a VTE host), copies\n   third_party/terminator/pwn_shift_enter.py to\n   ~/.config/terminator/plugins/ and enables the PWNShiftEnter\n   plugin in ~/.config/terminator/config — WITH confirmation and\n   a .pwnbak backup. This is the only VTE emulator we can fix at\n   the GTK layer without patching libvte itself.\n\nEverything here is host-config mutation, which is why it lives in ‘pwn setup` and NOT in the REPL’s runtime path. See GNOME/vte issues #2601 / #2607 for why VTE can’t be fixed with escape sequences alone.\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.which Usage"},{"role":"assistant","content":"`PWN::Setup.which`: "}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.710
+  version: 0.5.712
 platform: ruby
 authors:
 - 0day Inc.
@@ -5478,6 +5478,7 @@ files:
 - etc/default_skills/pwn/sdr/son_micro_rfid/SKILL.md
 - etc/default_skills/pwn/sessions/SKILL.md
 - etc/default_skills/pwn/setup/SKILL.md
+- etc/default_skills/pwn/setup/references/urls.md
 - etc/default_skills/pwn/version/SKILL.md
 - etc/default_skills/pwn/www/SKILL.md
 - etc/default_skills/pwn/www/app_cobalt_io/SKILL.md