Testing & Debugging

Running Tests

The project uses JUnit 5 for testing.

Unit Tests

Run the standard test suite:

./gradlew test

Integration Tests

Some tests require a local Ollama instance or mock server. Ensure your environment is set up if running the full suite.

Building from Source

To build the extension JAR:

./gradlew clean shadowJar

The output JAR will be in build/libs/Burp-AI-Agent-<version>.jar.

Debugging

If the extension is behaving unexpectedly, check the logs.

1. Burp Extension Output

In Burp Suite:

  1. Go to ExtensionsInstalled.

  2. Select Burp AI Agent.

  3. Click the Output tab.

    • Standard Output: Shows general info and initialization messages.

    • Errors: Shows Java stack traces if the extension crashes.

2. Java Logs

The extension uses SLF4J. Logs are typically printed to the Burp stdout. If you launched Burp from a terminal, check the terminal window for detailed logs.

3. Agent Debugging

If a backend is failing:

  1. Check the Status indicator in the top bar.

  2. If it says Crashed, check Extensions → Installed → Burp AI Agent → Output/Errors for the exit code.

  3. Check the audit.jsonl file (if Audit Logging is enabled) to see exactly what was sent to the model.

Manual UI Checks

Before a release, perform these sanity checks:

Last updated