Shipped · beta

pentest-cli

Deny-by-default scope enforcement for authorised testing, with a workflow engine and eight report formats.

Updated Jul 2026PythonTextualpytestRuffmypyPublic repository

Problem

Security tooling is easy to point at the wrong target. A scope mistake is not a cosmetic error — it can turn an authorised assessment into an unauthorised one. I wanted a command-line tool where the safe behaviour was the default, not an option someone remembered to set.

Design

The tool centres on a scope gate. Targets are allowed only when they match an explicit, authorised scope; everything else is refused. The gate emits audit events, and secrets are redacted before they reach logs or reports. Around that gate sit eleven plugins with risk tiers, a workflow engine for repeatable runs, a Textual terminal interface, and eight report formats.

Scope and limits

The scope checker is a control, not a substitute for a signed engagement. Authorisation still comes from the client, and the tool is explicit about that boundary. CI runs Ruff, mypy in strict mode, and pytest with coverage on every change.

Outcome

A public MIT-licensed release (v0.5.0 beta) with a documented security policy and private disclosure route. It is the strongest fully public artefact in the portfolio and the basis for the planned Scope Gate exhibit.

Limitations

Beta software, maintained by one person, with no external adoption figures to claim. It is a tool for authorised testing only.

← Back to work