How marcussanmg/kali-dotfiles works
Kali Workstation is a personal Kali Linux dotfiles environment for pentesting and lab work. The main workflow is to open a terminal with a persistent tmux session, set an engagement target, and keep target and network context visible while working with tools, notes, and browser-testing software. The documented configuration also covers desktop controls, session recovery, screenshots, and BloodHound helpers. Relationships here follow the README; source excerpts were not available, so uncertain script-level wiring is omitted.
Main entry points: .zshrc Zsh Shell · config i3 Desktop · tmux-attach-picker Session Picker · kitty.conf Kitty Terminal
Components 22
Desktop
- i3 Desktop
i3/config - Rofi Menus
rofi - Desktop Utilities
bin - Screenshots
bin/screenshot
Terminal Workflow
- Kitty Terminal
kitty/kitty.conf - tmux Sessions
tmux/tmux.conf - Session Picker
bin/tmux-attach-picker - Session Helpers
tmux/scripts - Zsh Shell
zsh/.zshrc
Engagement Context
- Target Selection
bin/set-target - Target Status
i3blocks/scripts/target - Network Status
i3blocks/scripts - Engagement Helpers
bin - Organized Toolkit
bin
Tools and References
- Firefox Setup
firefox/policies.json - Burp Helpers
bin/setup-burp.sh - BloodHound Helpers
bin - Reference Notes
cherrytree
Other components
- Pentester
- Host Network
- VPN Interface
- Clipboard
Connections 25
- Pentester → i3 Desktop: uses desktop
- i3 Desktop → Kitty Terminal: launches terminal
- i3 Desktop → Rofi Menus: opens menus
- i3 Desktop → Desktop Utilities: runs utilities
- Desktop Utilities → Screenshots: captures screen
- Screenshots → Clipboard: copies capture
- Kitty Terminal → tmux Sessions: starts server
- Pentester → Session Picker: opens picker
- Session Picker → tmux Sessions: lists sessions
- Session Picker → Kitty Terminal: opens session
- Pentester → Zsh Shell: runs commands
- Zsh Shell → Target Selection: sets target
- Zsh Shell → Engagement Helpers: runs helpers
- Zsh Shell → Reference Notes: opens notes
- i3 Desktop → Target Selection: sets target
- Zsh Shell → Target Status: provides target
- Target Status → i3 Desktop: shows target
- Network Status → Host Network: reads address
- Network Status → VPN Interface: reads address
- Zsh Shell → Host Network: reads interface
- Zsh Shell → VPN Interface: reads address
- Engagement Helpers → Organized Toolkit: organizes tools
- Pentester → Firefox Setup: launches browser
- Pentester → Burp Helpers: uses testing proxy
- Pentester → BloodHound Helpers: manages stack