Interactive TUI

Redactyl includes a terminal user interface (TUI) for exploring and managing findings interactively.

Starting the TUI

redactyl scan  # TUI is the default mode

Keyboard Shortcuts

Navigation

Key	Action
j / ↓	Move down
k / ↑	Move up
g	Go to top
G	Go to bottom
Enter	Expand/collapse finding
Tab	Switch panels

Filtering

Key	Action
/	Search findings
f	Filter by severity
F	Clear filters
s	Sort findings

Actions

Key	Action
o	Open file in editor
b	Baseline finding
i	Ignore finding
e	Export findings
r	Refresh scan

View

Key	Action
p	Toggle preview panel
c	Toggle context lines
d	Diff view
?	Show help
q	Quit

Severity Colors

Findings are color-coded by severity:

• Critical - Red background
• High - Red text
• Medium - Yellow text
• Low - Gray text

Preview Panel

Press Enter on a finding to see:

• Full file path with line numbers
• Syntax-highlighted code context
• Secret value (partially redacted)
• Detector information
• Suggested remediation

Baseline Workflow

1. Scan your project: redactyl scan
2. Review findings in the TUI
3. Press b to baseline known/acceptable secrets
4. Baseline is saved to .redactyl-baseline.json
5. Future scans will skip baselined findings

Export Options

Press e to export findings:

• JSON - Machine-readable format
• SARIF - GitHub Code Scanning format
• CSV - Spreadsheet format
• Markdown - Documentation format

Virtual File Extraction

For secrets found in archives or containers:

1. Select the finding
2. Press x to extract
3. File is extracted to a temp directory
4. Opens in your default editor

Environment Variables

Customize TUI behavior:

# Set default editor
export EDITOR=code

# Disable colors
export NO_COLOR=1

# Set terminal width
export COLUMNS=120