bb-recon

bb-recon is a command for Claude Code from allsmog/blackbox-claude-plugin. It costs 41 tokens per session (983 once invoked), scanned B, original, MIT.

A command for network reconnaissance, meaning the process of finding open ports, running services, and possible entry points on a target system.

In plain words
What is it for?
Use it in authorized security assessments to run quick, full, targeted, or UDP scans with Nmap and review discovered services and versions.
Why use it?
It turns several port and service scans into a repeatable workflow and records the results for later analysis.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: names the TodoWrite tool.

Part of the blackbox-htb plugin — 17 skills, 11 commands, 9 agents shipped together

Good fit Use it in authorized security assessments to run quick, full, targeted, or UDP scans with Nmap and review discovered services and versions.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/allsmog/blackbox-claude-plugin/bb-recon
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/allsmog/blackbox-claude-plugin

Made for: Claude Code.

Or install blackbox-htb, the plugin that ships this one along with the rest of its 17 skills, 11 commands, 9 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bb-recon

README.md
[![agentmods](https://agentmods.dev/badge/commands/allsmog/blackbox-claude-plugin/bb-recon.svg)](https://agentmods.dev/commands/allsmog/blackbox-claude-plugin/bb-recon)
Your own site
<a href="https://agentmods.dev/commands/allsmog/blackbox-claude-plugin/bb-recon"><img src="https://agentmods.dev/badge/commands/allsmog/blackbox-claude-plugin/bb-recon.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 983 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00041 $0.00983
Opus 5 $0.00020 $0.00491
Sonnet 5 $0.00008 $0.00197
Haiku 4.5 $0.00004 $0.00098

Measured 7d ago against content hash b0088dcf00e2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade B, and why

bb-recon scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo nmap -sU --top-ports 50 -oA recon/nmap_udp <TARGET>
blackbox-htb/commands/bb-recon.md · 149 lines

How it starts

The opening of the file, as written. The whole thing — 149 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Network Reconnaissance

Overview

Performs comprehensive network reconnaissance to discover open ports, running services, and potential attack vectors.

Scan Strategy

Quick Scan (Default)

Fast discovery of common ports with service detection:

nmap -sC -sV -oA recon/nmap_quick <TARGET>

Full TCP Scan

Complete port coverage (takes longer):

nmap -p- -T4 --min-rate=1000 -oA recon/nmap_full <TARGET>

Targeted Scan

After discovering open ports, run detailed scan:

nmap -sC -sV -p<PORTS> -oA recon/nmap_targeted <TARGET>

UDP Scan

Check for UDP services (requires root):

sudo nmap -sU --top-ports 50 -oA recon/nmap_udp <TARGET>

Execution Flow

Step 1: Create Output Directory

mkdir -p recon

Step 2: Run Quick Scan

nmap -sC -sV -oA recon/nmap_quick <TARGET>

Parse output and identify:

  • Open ports
  • Service versions
  • Script output (default NSE scripts)
  • OS detection hints

Step 3: Run Full Port Scan (Background)

nmap -p- -T4 --min-rate=1000 -oA recon/nmap_full <TARGET> &

Step 4: Analyze Results

For each discovered service, note:

  • Port number
  • Service name
  • Version information
  • Any banners or additional info

Common Port Analysis

Port Service Next Steps
21 FTP Check anonymous login, version exploits
22 SSH Banner grab, check version, brute force
23 Telnet Check for auth bypass, credentials
25 SMTP User enumeration, relay testing
53 DNS Zone transfer, subdomain enum
80/443 HTTP/S Web enumeration, nikto, gobuster
110/143 POP3/IMAP Mail enumeration
139/445 SMB Share enum, null session, vuln scan
389/636 LDAP AD enumeration, anonymous bind
1433 MSSQL Default creds, xp_cmdshell
3306 MySQL Default creds, UDF
3389 RDP BlueKeep, brute force
5432 PostgreSQL Default creds
5985/5986 WinRM Evil-WinRM access
6379 Redis Unauth access, RCE
8080 HTTP-Alt Web enumeration
27017 MongoDB Unauth access

Read the full file on GitHub · 149 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 149 lines · 41 tokens per session scan B b0088dcf00e2

Subscribe to this mod's changes

bb-recon is a command published in the GitHub repository allsmog/blackbox-claude-plugin (5 stars, last pushed 6mo ago), licensed MIT. It adds 41 tokens to every session and 983 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.