README.md

March 4, 2026 · View on GitHub

SentinelX

High-Performance Zsh Theme for Offensive Security.

SentinelX is a lightweight, high-fidelity Zsh theme optimized for penetration testing and red teaming. It provides real-time situational awareness and process tracking for long-running security tools.

Key Features

  • Live Process Spinner: Uses gum to provide a visual heartbeat for tools like nmap and ffuf.
  • VPN Guard: Automatic icon (󰖂) when tun0 or wg0 is active.
  • Privilege Alert: Dynamic Red Skull (󱗓) and red username when running as root.
  • Execution Timer: Displays command duration (e.g., 45s 󱑎) in the status bar.
  • Dual-Line UI: Separates metadata from the input line for cleaner payload typing.

Pentest Aliases

AliasCommandPurpose
nscannmap -Pn -sC -sVStealthy service discovery
fscannmap -p- -T4Full port discovery
dirbffuf -recursionDirectory fuzzing
git-clonegit cloneDirectory fuzzing

Quick Start

  1. Prerequisites: Install a Nerd Font and golang.
  2. Install:
cat sentinelx.zsh >> ~/.zshrc && source ~/.zshrc
  1. Usage:
scan <command>  # Runs any command with the live spinner

Demo Image:

image