AFLplusplus / AFLplusplus/LibAFL

docs: add AGENTS.md for AI agents to help someone build a new LibAFL-based fuzzer

Đang mở
#3,896 3 bình luận 0 reaction 0 người được giao Xem trên GitHub
enhancement
Ngôn ngữ chính
Rust
Star
2.6k
Fork
481
Merge trung bình
2 ngày 30 phút
Pull request đã merge (30 ngày)
16

Mô tả

## The Problem

LibAFL is a set of building blocks for creating a fuzzer it does not come as one ready-to-use fuzzer. To get started, a new user has to:

1. Look through the `fuzzers/` folder, which has around 69 example projects.
2. Guess which example is closest to their target program.
3. Copy that example and manually edit the Rust code to fit their case.

This is confusing and slow for beginners, since it requires understanding LibAFL's internal pieces just to get a first fuzzer running.

## The Idea

Add a simple command-line tool:

```
cargo libafl new
```

Instead of browsing and guessing, the tool asks a few short questions, such as:

- Is the target's source code available, or only the compiled binary?
- Should it run on one CPU core, or many?

Based on the answers, the tool automatically:

- Picks the closest matching example as a base.
- Generates a ready-to-compile fuzzer project with the correct setup already
filled in.

## Why It Helps

- Removes the hardest part for new users: figuring out where to start.
- Does not change or touch LibAFL's core fuzzing engine it only generates
starter code, so it's low-risk to add.
- Lets a beginner go from "I have a target" to "I have a working fuzzer"
in a few minutes instead of hours of trial and error.

## Simple Analogy

LibAFL today is like a warehouse of furniture parts with 40 old instruction manuals you find the closest manual and adjust it yourself. This tool is a short questionnaire that hands you back the one correct, filled-in manual for
your exact case.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.