Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AdithyaaSivamal/Agentic-AFL/llms.txt

Use this file to discover all available pages before exploring further.

agentic-afl plot generates a coverage-over-time plot from a campaign JSON result file saved with --log-dir. It delegates rendering to the experiments/tests/plot_coverage.py script bundled in the repository and saves the output as a PNG image.

​
Synopsis

agentic-afl plot <json_file> [-o <output>]

​
Arguments

​
json_file
string
required
Path to the campaign JSON result file produced by agentic-afl fuzz --log-dir. The file must exist; the command exits with an error if it cannot be found.
​
-o / --output
string
default:"None"
Output image path. Defaults to the same name as the JSON file with a .png extension — for example, ./results/harness_20250101_120000.json produces ./results/harness_20250101_120000.png. Specify this flag to write the image to a different location or filename.

​
Examples

Plot commands
# Generate coverage.png from campaign results (output defaults to same stem)
agentic-afl plot ./results/harness_20250101_120000.json

# Specify an explicit output path
agentic-afl plot ./results/harness_20250101_120000.json -o ./charts/coverage.png

​
Output Format

The plot shows edges_found (Y-axis) over time_seconds (X-axis), drawn as a continuous line reflecting cumulative AFL++ edge discovery throughout the campaign. Payload injection events are drawn as vertical markers sourced from the timeline array in the JSON file, making it easy to see which injections correlated with coverage jumps. The finished image is saved at the resolved output path, and a confirmation line is printed to stdout:
Confirmation message
✓ Plot saved: ./results/harness_20250101_120000.png
agentic-afl plot requires the experiments/tests/plot_coverage.py script to be present in the repository. The command resolves the script path relative to the installed package location and will exit with an error if the file is missing.

Build docs developers (and LLMs) love

Get started for freeTalk to us