Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

reptr add

Add a new finding to an engagement — either a blank stub or one imported from your finding library.

Usage

reptr add finding [OPTIONS] [TITLE]
OptionDefaultDescription
--severitymediumOne of critical, high, medium, low, info
--fromLibrary template name (e.g. web/xss-stored)
--path.Engagement root directory

Create a blank stub

reptr add finding "SQL Injection in Login Form" --severity critical
# Created findings/002-sql-injection-in-login-form.md

The filename is auto-derived from the title (lower-cased, spaces → hyphens), prefixed with the next available sequence number. The finding ID (F-NNN) matches the sequence number.

Import from a library

reptr add finding "Stored XSS in Comments" --from web/xss-stored
# Created findings/003-stored-xss-in-comments.md

The imported file keeps the template’s severity, CVSS, CWE, body markdown, and all other fields. Only the id is freshly assigned and the title is overridden if you passed one.

If you omit TITLE, the template’s own title is used:

reptr add finding --from web/sql-injection
# Created findings/004-sql-injection.md  (title from template)

See reptr library for how to manage templates.

Stub format

---
id: F-002
title: SQL Injection in Login Form
severity: critical
status: open
affected_assets: []
tags: []
# Optional — uncomment and fill in as needed:
# cvss: "0.0"
# cvss_vector: "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:N"
# cwe: "CWE-000"
# owasp: "A00:2021"
---

## Description

## Proof of Concept

## Impact

## Remediation

## References