<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->
<!-- NERF is a trademark of defconxt. -->
# conducting-john-the-ripper-analysis — API Reference

## Agent Script

| Command | Description |
|---------|-------------|
| `crack --target <path>` | Execute John the Ripper attack. |
| `detect_format --target <path>` | Detect hash format from file. |
| `show --target <path>` | Display cracked passwords from pot file. |

## Usage Examples

```bash
# Execute John the Ripper attack.
node scripts/agent.js crack --target ./sample

# Detect hash format from file.
node scripts/agent.js detect_format --target ./sample

# Display cracked passwords from pot file.
node scripts/agent.js show --target ./sample
```

## Output Format

All commands return JSON with the following structure:

```json
{
  "action": "<command>",
  "result": {
    "action": "<command>",
    "status": "complete",
    "domain": "<domain>",
    "technique": "conducting-john-the-ripper-analysis"
  }
}
```
