| mode | Mode to run: cli (default) or atheris. | no | cli |
| version | Release tag to download (e.g., v1.2.3). Defaults to the action ref if it looks like a tag. For branch, SHA, or local checkouts, set this explicitly; use latest only if you want a mutable release. Ignored when binary_path is set.
| no | "" |
| binary_path | Path to a local pickle-fuzzer binary to install instead of downloading a release asset. Mutually exclusive with version.
| no | "" |
| args | Arguments passed directly to pickle-fuzzer. If set, other inputs are ignored.
| no | "" |
| output_dir | Output directory for batch generation (maps to --dir). | no | "" |
| output_file | Output file path for single file mode (positional FILE). | no | "" |
| samples | Number of samples to generate (maps to --samples). | no | "" |
| protocol | Pickle protocol version 0-5 (maps to --protocol). | no | "" |
| seed | Seed for reproducible generation (maps to --seed). | no | "" |
| min_opcodes | Minimum opcodes to generate (maps to --min-opcodes). | no | "" |
| max_opcodes | Maximum opcodes to generate (maps to --max-opcodes). | no | "" |
| mutators | Comma or space separated mutators (maps to repeated --mutators flags).
| no | "" |
| mutation_rate | Mutation probability 0.0-1.0 (maps to --mutation-rate). | no | "" |
| unsafe_mutations | Allow mutations that may produce invalid pickles. | no | false |
| allow_ext | Allow EXT* opcodes (requires extension registry). | no | false |
| allow_buffer | Allow buffer opcodes (requires out-of-band buffer support). | no | false |
| install_only | Only install pickle-fuzzer without running it. | no | false |
| python_version | Python version for atheris mode. | no | 3.11 |
| harness | Path to the Atheris harness script (required for atheris mode). | no | "" |
| harness_args | Whitespace-delimited arguments passed to the harness script (atheris mode). | no | "" |