axira is a minimal, pentester-focused oh-my-zsh theme designed for clean, useful, and context-rich prompts.
It automatically shows your active VPN or network IP, your user context, Python virtual environments, Git branches, and clear indicators for root access.
-
Multi-line prompt
Displays the current working directory, user, hostname, interface name, and IP address in a clean format. -
Dynamic VPN-aware IP detection
Dynamically shows your VPN IP if connected, otherwise falls back to your localeth0IP. Perfect for CTFs, labs, and external networks. -
Dynamic prompt
Usessetopt prompt_substto refresh the network information every time you hit Enter. No more stale IPs. -
Root warning
If you are root (sudo -sorsudo su), the entire prompt turns red to warn you clearly. -
Python virtual environment
Displays the active Python virtual environment name when one is active. -
Git branch detection
Shows the current Git branch if you are in a Git repository. -
Command status indicator
Shows ✔ if the last command succeeded, or ✗ if it failed, on the right-hand side (RPROMPT).
┌─[~/HTB] [kali@MyLaptop | tun0 10.8.0.2]
└─➜ # When VPN is connected
┌─[~] [kali@MyLaptop | eth0 192.168.1.10]
└─➜ # When VPN is disconnected
┌─[~] [root@MyLaptop | eth0 192.168.1.10]
└─➜ # Root user - whole prompt in red
-
Copy the theme file to your Oh My Zsh custom themes folder:
mkdir -p ~/.oh-my-zsh/custom/themes cp axira.zsh-theme ~/.oh-my-zsh/custom/themes/
-
Edit your
.zshrc:ZSH_THEME="axira" -
Make sure
setopt prompt_substis in the theme (included by default).
This ensures that your VPN IP/interface always refreshes automatically. -
Reload your shell:
source ~/.zshrc
- Pentesters who need to quickly see which network (VPN or local) they are using
- CTF players on Hack The Box, TryHackMe, or labs
- Developers who want minimal distractions but clear context
MIT License. Free to use, modify, and share.