Installation

Prerequisites

1. Burp Suite Community or Professional (2023.12+ recommended).

2. Java 21 for building from source.

Recent Burp versions include bundled Java runtime for extension execution. Separate Java is mainly needed for local builds.

Install Path

Download from Releases

1. Open GitHub Releases.

2. Download latest Burp-AI-Agent-<version>.jar.

Build from Source

Load into Burp Suite

1. Open Extensions -> Installed -> Add.

2. Select extension type Java.

3. Choose the JAR file.

4. Complete load wizard.

Screenshot: Burp extensions add

Verify Installation

Expected indicators:

• extension loads without startup errors,

• AI Agent tab appears in Burp main navigation.

Runtime Directory

On first start, ~/.burp-ai-agent/ is created:

~/.burp-ai-agent/
├── audit.jsonl
├── bundles/
├── contexts/
├── backends/
├── certs/
│   └── mcp-keystore.p12
└── AGENTS/
    ├── default
    ├── pentester.md
    ├── bughunter.md
    └── auditor.md

Custom additions:

• profiles: ~/.burp-ai-agent/AGENTS/*.md (Agent Profiles)

• backend plugins: ~/.burp-ai-agent/backends/ (Adding a Backend)

Troubleshooting

• Extension load failure: inspect Burp Errors/Output tabs and Java version.

• Tab missing: ensure extension is enabled.

• Permission errors: ensure write access to ~/.burp-ai-agent/.

Next Steps

Continue with Quick Start.