gitwtfhub

wtf is claudebrain?

encod3d-sec/claudebrain — explained in plain English

Analysis updated 2026-05-18

218PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

An Obsidian based knowledge base and Claude Code automation toolkit for authorized penetration testing and bug bounty engagements.

Mindmap

mindmap
  root((ClaudeBrain))
    What it does
      Offensive security wiki
      Automated hunt skills
      Engagement state tracking
    Tech stack
      Python
      Claude Code
      Obsidian
    Use cases
      Bug bounty hunting
      Authorized pentesting
    Audience
      Security researchers
      Pentesters

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

Look up hacking techniques for a specific vulnerability class during an authorized engagement.

REASON 2

Automate which security testing skill Claude Code loads based on the current prompt.

REASON 3

Track scope, findings, and progress for a client pentest or bug bounty program.

REASON 4

Check tracked files for accidental leaks of private client data before pushing.

What's in the stack?

PythonClaude CodeObsidianMCP

How it stacks up

encod3d-sec/claudebrainwubing2023/paperspinekonbakuyomu/smartsearch
Stars218220221
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity4/53/52/5
Audiencedeveloperresearcherdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Linux or WSL, Python 3.10+, the Claude Code CLI, Node.js 18+, and bun, plus a bootstrap script that modifies local Claude Code configuration.

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

Wtf does this do

ClaudeBrain is a knowledge base and automation toolkit built for security professionals who do authorized penetration testing and bug bounty hunting using the Claude Code AI assistant. It turns a personal notes app called Obsidian into a structured library of over 500 pages covering hacking techniques, paired with automation that tells Claude Code which technique to check before it tries anything against a target. The README is explicit that it is meant only for legal, authorized work such as a signed penetration test, an in scope bug bounty program, or a personal lab or CTF challenge. The core idea is that instead of the AI figuring things out from scratch every time, it always consults this shared, growing wiki first, similar in spirit to well known references like HackTricks. The wiki is organized into folders covering things like Active Directory, cloud services, web applications, networking, and specific tools, plus payload examples for different vulnerability types. On top of the wiki sit "hunt skills," one for each major vulnerability category such as cross site scripting, SQL injection, or server side request forgery, each of which is expected to search the wiki before acting and to report findings in a consistent format. Automation is handled through small Python scripts that hook into different moments in a Claude Code session: one matches what the user typed against a list of triggers to load the right skill, another fingerprints technology it discovers and routes it to relevant tests, another sets up a new engagement's file structure, and one warns if a command seems to target something outside the agreed scope. Each engagement, such as work for one client, is tracked in its own folder that is deliberately excluded from version control, so private client details never get pushed to a public repository, and a script exists specifically to check for accidental leaks before pushing. To use it, someone needs Linux or WSL, Python 3.10 or newer, the Claude Code CLI, Node.js 18 or newer, and a tool called bun. A setup script installs everything and wires the automation into the local Claude Code configuration, after which the user can start a new pentest, bug bounty, or CTF engagement with a single command. It is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through running the bootstrap setup script for ClaudeBrain.
Prompt 2
Explain how the hunt skills decide which vulnerability technique to try first.
Prompt 3
Show me how to start a new bug bounty engagement with this toolkit.
Prompt 4
Help me understand how the scope guard hook prevents out of scope testing.

Frequently asked questions

wtf is claudebrain?

An Obsidian based knowledge base and Claude Code automation toolkit for authorized penetration testing and bug bounty engagements.

What language is claudebrain written in?

Mainly Python. The stack also includes Python, Claude Code, Obsidian.

What license does claudebrain use?

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

How hard is claudebrain to set up?

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

Who is claudebrain for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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