How s0ld13rr/pentestcode works
PentestCode is a terminal-based autonomous penetration-testing agent. The main workflow is an operator prompt entering a session, a lead agent coordinating specialist agents and pentest tools, and parsed findings updating shared engagement state for further planning and reporting. The README documents these product capabilities; sampled source confirms the server route assembly and state-query tool, but does not expose the full agent dispatch or tool-execution path, so those documented links are cited to the README.
Main entry points: agent.ts Lead Agent · store.ts Engagement State · application-tools.ts Pentest Tools · app.tsx Terminal Session
Components 19
Operator Interface
- CLI Commands
packages/cli/src/commands/commands.ts - Terminal Session
packages/tui/src/app.tsx
Agent Orchestration
- Lead Agent
packages/core/src/agent.ts - Specialist Agents
packages/core/src/config/agent.ts - Task Coordination
packages/core/src/engagement/orchestrator.ts
Pentest Operations
- Pentest Tools
packages/core/src/tool/application-tools.ts - Tool Registry
packages/core/src/tool/registry.ts - Finding Parsers
packages/core/src/tool/application-tools.ts - Skills
packages/core/src/skill/discovery.ts
Engagement Memory
- Engagement State
packages/core/src/engagement/store.ts - State Queries
packages/opencode/src/tool/state-query.ts - Attack Paths
packages/core/src/engagement/task-graph.ts - Findings Reports
packages/core/src/engagement
Runtime Platform
- HTTP API
packages/server/src/routes.ts - LLM Providers
packages/core/src/plugin/provider.ts - LLM Routing
packages/llm/src/route/client.ts - Persistent Storage
packages/opencode/src/storage/storage.ts
Other components
- Operator
- Target Systems
Connections 21
- Operator → CLI Commands: runs commands
README.md - Operator → Terminal Session: starts session
README.md - CLI Commands → Lead Agent: submits prompt
- Terminal Session → Lead Agent: submits prompt
- Lead Agent → Task Coordination: plans tasks
README.md - Task Coordination → Specialist Agents: dispatches agents
README.md - Lead Agent → Pentest Tools: uses tools
README.md - Pentest Tools → Tool Registry: registers tools
- Pentest Tools → Target Systems: tests services
README.md - Pentest Tools → Finding Parsers: parses output
README.md - Finding Parsers → Engagement State: records findings
README.md - Specialist Agents → Engagement State: shares state
README.md - Lead Agent → Skills: loads knowledge
README.md - Lead Agent → LLM Routing: requests inference
- LLM Routing → LLM Providers: routes requests
packages/llm/src/route/client.ts - Terminal Session → HTTP API: uses API
- State Queries → Engagement State: queries state
packages/opencode/src/tool/state-query.ts - Lead Agent → Attack Paths: suggests routes
README.md - Engagement State → Findings Reports: feeds findings
README.md - Engagement State → Persistent Storage: persists state
- HTTP API → Engagement State: provides services