Interactive TUI
Navigate findings with vim-style keyboard shortcuts
Redactyl includes a powerful terminal user interface (TUI) for exploring and managing findings interactively.
Starting the TUI
redactyl scan # TUI is the default modeKeyboard 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
- Scan your project:
redactyl scan - Review findings in the TUI
- Press
bto baseline known/acceptable secrets - Baseline is saved to
.redactyl-baseline.json - 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:
- Select the finding
- Press
xto extract - File is extracted to a temp directory
- 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