by PlamenTSV
Autonomous Web3 security audit agent for Claude Code
# Add to your Claude Code skills
git clone https://github.com/PlamenTSV/plamenAutonomous smart contract security auditor for Claude Code.
Orchestrates 15-95 AI agents across 8 phases to produce audit reports with verified PoC exploits. Supports EVM/Solidity, Solana/Anchor, Aptos Move, and Sui Move.
Claude Code CLI, Python 3.11-3.12 + pip, Node.js 18+, Git
macOS: Also run
xcode-select --install(needed for C++ dependency compilation).Windows: Enable Developer Mode before installing (required for symlinks). Settings > System > For Developers > toggle ON. Or in admin PowerShell:
reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock /v AllowDevelopmentWithoutDevLicense /t REG_DWORD /d 1 /fPer-language tools (Foundry, Solana CLI, etc.) are installed automatically via
plamen setup.
Open Claude Code and paste the contents of SETUP.md. Claude handles cloning, symlink installation, dependency setup, and RAG database building automatically.
Linux / macOS:
git clone https://github.com/PlamenTSV/plamen.git ~/.plamen
export SOLODIT_API_KEY=your_key_here # free at solodit.cyfrin.io (recommended for RAG quality)
cd ~/.plamen && python3 plamen.py install
No comments yet. Be the first to share your thoughts!
Windows (PowerShell):
git clone https://github.com/PlamenTSV/plamen.git $HOME\.plamen
$env:SOLODIT_API_KEY = "your_key_here" # free at solodit.cyfrin.io (recommended for RAG quality)
cd $HOME\.plamen; python plamen.py install
Python dependencies are installed automatically on first run. On macOS/Linux use
python3, on Windows usepython. SetSOLODIT_API_KEYbefore install — the RAG database builds during setup and Solodit is the largest source (3400+ findings).
After install, add to PATH so you can run plamen from anywhere:
Linux (bash):
echo 'export PATH="$HOME/.plamen:$PATH"' >> ~/.bashrc && source ~/.bashrc
macOS (zsh):
echo 'export PATH="$HOME/.plamen:$PATH"' >> ~/.zshrc && source ~/.zshrc
Windows (PowerShell, one-time):
[System.Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\.plamen;" + [System.Environment]::GetEnvironmentVariable("Path", "User"), "User")
Then use plamen from anywhere:
plamen # interactive wizard
plamen setup # install tools + build RAG
plamen rag # rebuild RAG database only
plamen uninstall # remove Plamen from ~/.claude
Important: Always use
plamen(notpython3 plamen.py) after PATH is set. Thepython3 plamen.pyform only works from inside~/.plamen/.
The installer:
~/.plamen into ~/.claude/ so Claude Code discovers Plamen's agen...