gitwtfhub

wtf is pentestcode?

s0ld13rr/pentestcode — explained in plain English

Analysis updated 2026-05-18

230TypeScriptAudience · developerComplexity · 5/5LicenseSetup · moderate

TL;DR

A terminal-based AI agent that automates authorized penetration testing by coordinating 13 specialist AI agents that share one memory of the target engagement.

Mindmap

mindmap
  root((PentestCode))
    What it does
      Autonomous pentest agent
      Shared engagement state
      Multi agent team
    Tech stack
      TypeScript
      Bun
      AI SDK
    Use cases
      Authorized pentesting
      CTF practice
      Report generation
    Audience
      Security researchers
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Automate an authorized penetration test against a target network.

REASON 2

Practice offensive security skills on capture the flag challenges.

REASON 3

Track hosts, vulnerabilities, and credentials discovered during a live engagement.

REASON 4

Generate a written pentest report from an automated engagement.

What's in the stack?

TypeScriptBunAI SDK

How it stacks up

s0ld13rr/pentestcode40rbidd3n/hydro0x01fastify/demo
Stars230229227
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-30
MaintenanceActive
Setup difficultymoderatehardmoderate
Complexity5/54/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs an API key or account for one of 20+ supported LLM providers to run.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

PentestCode is a terminal based AI agent built to carry out authorized penetration testing engagements, meaning simulated attacks that security teams run against their own systems to find weaknesses before real attackers do. A user gives it a target and a goal in plain language, and it runs security tools, reads the results, updates its understanding of the network, and decides on its own what to try next, similar to how a human tester would work through an engagement. It began as a fork of a coding assistant project called OpenCode, with the code editing parts removed and replaced with offensive security capabilities. Instead of one AI model doing everything, the system splits the work across 13 specialized agents that run in parallel, each with its own instructions and set of allowed tools. One lead agent plans the engagement and hands out tasks to others focused on reconnaissance, scanning, finding entry points, identity and Active Directory attacks, web application testing, and reporting. All of these agents read from and write to one shared memory of the engagement, so a finding made by one agent, such as an open port, is immediately visible to the others. This shared state tracks discovered hosts, vulnerabilities, stolen credentials, gained access, and relationships between all of these, and it persists between sessions so a user can close the terminal and pick up later where they left off. The project ships 18 built in tools for parsing the output of common security scanners into this shared state, plus 19 optional knowledge packs covering specific services and attack playbooks that load only when needed. It works with more than 20 different AI providers, including Anthropic and OpenAI, through a common library. Installing it is a single command that downloads a self-contained binary with no separate runtime needed, and the README describes it as beta software intended for real engagements and practice environments like capture the flag competitions.

Yoink these prompts

Prompt 1
Explain how the shared engagement state lets PentestCode's agents cooperate.
Prompt 2
Walk me through installing and running a one-shot scan with PentestCode.
Prompt 3
What are the 13 specialist agents in this system and what does each one do?
Prompt 4
How does the attack path suggestion tool use the relationship graph to plan next steps?

Frequently asked questions

wtf is pentestcode?

A terminal-based AI agent that automates authorized penetration testing by coordinating 13 specialist AI agents that share one memory of the target engagement.

What language is pentestcode written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, AI SDK.

What license does pentestcode use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pentestcode to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pentestcode for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.