forensics-analyst

forensics-analyst is an agent for Claude Code from 0xSteph/pentest-ai-agents. It costs 45 tokens per session (5,947 once invoked), scanned D, original, MIT.

A digital-forensics and incident-response agent for investigating possible security incidents and preserving electronic evidence. Digital forensics examines devices, memory, networks, and timelines to determine what happened.

In plain words
What is it for?
Use it for evidence collection, disk and memory analysis, incident timelines, cross-source investigation, and chain-of-custody documentation.
Why use it?
It reduces the risk of changing evidence or losing track of who handled it, which can make findings unreliable or legally difficult to defend.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the pentest-ai-agents plugin — 3 commands, 52 agents shipped together

About the project

0xSteph/pentest-ai-agents is a collection of Claude Code specialist agents for authorized penetration testing and security research, covering areas such as reconnaissance, web systems, cloud, reverse engineering and detection. Security researchers and penetration testers use it to plan engagements, investigate findings, build detections and write reports. The catalogue entries are the project's own agents, commands and plugin components.

0xSteph/pentest-ai-agents · 2,198 stars · on GitHub · pentestai.xyz

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/0xsteph/pentest-ai-agents/forensics-analyst
Clone the repo
git clone --depth 1 https://github.com/0xSteph/pentest-ai-agents

Made for: Claude Code.

Or install pentest-ai-agents, the plugin that ships this one along with the rest of its 3 commands, 52 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for forensics-analyst

README.md
[![agentmods](https://agentmods.dev/badge/agents/0xsteph/pentest-ai-agents/forensics-analyst.svg)](https://agentmods.dev/agents/0xsteph/pentest-ai-agents/forensics-analyst)
Your own site
<a href="https://agentmods.dev/agents/0xsteph/pentest-ai-agents/forensics-analyst"><img src="https://agentmods.dev/badge/agents/0xsteph/pentest-ai-agents/forensics-analyst.svg" alt="Measured on agentmods" height="20"></a>
Per session 45 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 5,947 The whole file, excluding the scripts and references it only reads on demand.
Security scan D 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.05947
Opus 5 $0.00023 $0.02974
Sonnet 5 $0.00009 $0.01189
Haiku 4.5 $0.00005 $0.00595

Measured 7d ago against content hash 0e361ca17942, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade D, and why

forensics-analyst scanned grade D with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- **/var/log/auth.log** (Debian/Ubuntu) or **/var/log/secure** (RHEL/CentOS): Authentication events, sudo usage, SSH logins, failed login attempts, su commands.

Reaches for credential fileshighPrivilege escalation

SSH keys, cloud credentials, git-credentials, .npmrc, /etc/shadow: reading these is how a config file becomes a credential leak.

- **SSH artifacts**: `~/.ssh/authorized_keys`, `~/.ssh/known_hosts`, `/var/log/auth.log` SSH entries, `/etc/ssh/sshd_config` for permitted authentication methods.
agents/forensics-analyst.md · 513 lines

How it starts

The opening of the file, as written. The whole thing — 513 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Digital Forensics and Incident Response Agent

You are a digital forensics and incident response (DFIR) specialist. You guide users through evidence acquisition, analysis, and reporting while maintaining forensic soundness and chain of custody. Every recommendation must prioritize evidence integrity and legal defensibility.

Behavioral Rules

  • Always preserve evidence integrity; document hash values (MD5, SHA-1, SHA-256) at every stage
  • Follow the order of volatility: collect RAM first, then disk, then network logs, then archival media
  • Maintain chain of custody at all times with documented transfers, timestamps, and handler identities
  • Work on forensic copies, never the original evidence
  • Document every action taken during analysis, including tools used, commands run, and timestamps
  • Correlate findings across multiple evidence sources before drawing conclusions
  • Distinguish between facts and interpretations in all reporting
  • Note confidence levels (high, medium, low) for each finding
  • Never alter, delete, or overwrite evidence artifacts
  • Use write blockers or mount in read-only mode before accessing any storage media

1. Evidence Acquisition

Disk Imaging

Create bit-for-bit forensic images of all storage media. Always verify image integrity with cryptographic hashes.

Tools and techniques:

  • dd / dcfldd: Basic Unix imaging utilities. Use dcfldd for built-in hashing and progress reporting.
    dcfldd if=/dev/sda of=/cases/case001/disk.raw hash=sha256 hashlog=/cases/case001/disk.hash
    
  • dc3dd: Enhanced version of dd developed by the DoD Cyber Crime Center with on-the-fly hashing and error handling.
  • FTK Imager: GUI-based acquisition tool supporting E01, AFF, and raw formats. Produces hash verification reports automatically.
  • Guymager: Open-source Linux imaging tool with multi-threaded compression and built-in hash verification.

Write blockers:

  • Always use a hardware write blocker (Tableau, WiebeTech) or verified software write blocker before connecting suspect media.
  • Verify write blocker functionality before each use with a known test drive.

Read the full file on GitHub · 513 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 513 lines · 45 tokens per session scan D 0e361ca17942

Subscribe to this mod's changes

forensics-analyst is an agent published in the GitHub repository 0xSteph/pentest-ai-agents (2,198 stars, last pushed 21d ago), licensed MIT. It adds 45 tokens to every session and 5,947 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it D with 2 findings (asks for root, reaches for credential files). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

tachi-risk-scorer

Quantitative risk scoring agent that enriches threat model findings with four-dimensional scores (CVSS 3.1, exploitability, scalability, reachability), computes weighted composite scores, attaches governance fields, and generates dual-format output (risk-scores.md and risk-scores.sarif).

davidmatousek/tachi · 65 tokens

active-directory

Active Directory and Windows domain attack specialist. Use for Kerberoasting, AS-REP roasting, DCSync, BloodHound enumeration, ADCS ESC attacks, Golden/Silver Ticket, and domain privilege escalation. Triggers on: kerberoast, AS-REP, bloodhound, DCSync, golden ticket, ADCS, ESC, domain controller, LDAP, GPO, AD, domain…

mukul975/Threatswarm · 86 tokens

exploit

Exploitation specialist for gaining initial access. Use when exploiting CVEs, running Metasploit modules, using searchsploit, obtaining shells, or executing proof-of-concept code. Triggers on: exploit, CVE-, initial access, get shell, msfconsole, owned, pwn, vulnerability exploit, remote code execution, RCE.

mukul975/Threatswarm · 73 tokens

iot-attacker

IoT and embedded systems security specialist. Handles firmware extraction and analysis, hardcoded credential discovery, UART/JTAG access, MQTT/CoAP protocol testing, RouterSploit exploitation, web interface attacks, and OT/ICS protocol analysis. Triggers on: IoT, firmware, binwalk, UART, JTAG, router, embedded…

mukul975/Threatswarm · 93 tokens

Demonstrate

Agent for demonstrating VS Code features.

microsoft/vscode · 10 tokens

playwright-test-generator

Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.

microsoft/playwright · 151 tokens