Shell Configuration Files

All user and root shell profiles used in PWNCLOUDOS are available for download and customization. These profiles provide cloud-centric CLI enhancements, prompt themes, aliases, and plugin integration.

Directory: docs/configs/shell/ GitHub: https://github.com/pwnedlabs/pwncloudos/tree/main/docs/configs/shell

ZSH Configuration (Linux Shell)

Files: .zshrc Paths: - docs/configs/shell/zsh/user/.zshrc - docs/configs/shell/zsh/root/.zshrc

Features

  • Starship prompt integration with custom theme

  • Kali-style cloud prompt

  • History optimization for shared and persistent history

  • Plugins: - zsh-autosuggestions - zsh-syntax-highlighting

  • Useful aliases and path enhancements

How to Apply

# Normal user
cp docs/configs/shell/zsh/user/.zshrc ~/.zshrc

# Root user
sudo cp docs/configs/shell/zsh/root/.zshrc /root/.zshrc

PowerShell Profile Configuration (Linux or Windows Terminal)

Two profile configurations are included for normal user and root.

User Profile

Path: docs/configs/shell/powershell/user/Microsoft.PowerShell_profile.ps1

Features

  • Colored multi-line prompt styled similarly to ZSH

  • Virtual environment detection ($VIRTUAL_ENV)

  • Enhanced directory formatting and color-coded output

  • Aliases: ll, la, l, reload

  • History expansion and 24-bit RGB ANSI color support

Root Profile

Path: docs/configs/shell/powershell/root/Microsoft.PowerShell_profile.ps1

Features

  • Same prompt structure as user profile

  • Red-tinted visuals for clear privilege separation

  • Safe aliases and history formatting

  • UTF-8 terminal support

How to Apply PowerShell Profiles

On Linux:

# User profile
mkdir -p ~/.config/powershell
cp docs/configs/shell/powershell/user/Microsoft.PowerShell_profile.ps1 ~/.config/powershell/

# Root profile
sudo mkdir -p /root/.config/powershell
sudo cp docs/configs/shell/powershell/root/Microsoft.PowerShell_profile.ps1 /root/.config/powershell/

On Windows (PowerShell):

# User profile (creates profile if not exists)
if (!(Test-Path -Path $PROFILE)) {
    New-Item -ItemType File -Path $PROFILE -Force
}
Copy-Item docs/configs/shell/powershell/user/Microsoft.PowerShell_profile.ps1 $PROFILE

Note

For root or Administrator profile on Windows, run PowerShell as Administrator and use the corresponding profile path stored in $PROFILE.

Optional: Verify Profile Load

Add this line at the end of each profile to verify it loads on shell start:

Write-Host "✅ PowerShell profile loaded for $env:USERNAME" -ForegroundColor Cyan

Or for ZSH:

echo "✅ ZSH profile loaded for $USER"

Tool Launcher Scripts

PWNCLOUDOS includes custom launcher scripts for each tool, allowing them to be executed directly from the XFCE menu or terminal. These launchers provide helpful descriptions, examples, and flags for common use cases.

All launcher files are located in:

Directory: docs/configs/launchers/ In PWNCLOUDOS system: /opt/<tool-category>/<tool-name>/<tool>_launcher.sh

Launcher Categories

Each launcher is grouped by its respective cloud or tool domain:

Example: AWeSomeUserFinder

Tool path: /opt/aws_tools/AWeSomeUserFinder/awesome_userfinder_launcher.sh Docs path: docs/configs/launchers/aws/awesome_userfinder_launcher.sh

📥 [Download Launcher](https://github.com/pwnedlabs/pwncloudos/raw/main/docs/configs/launchers/aws/awesome_userfinder_launcher.sh)

#!/bin/zsh
echo -e "\nAWeSomeUserFinder Tool"
echo -e "Usage example:"
echo -e "> python3 AWeSomeUserFinder.py -f -ak <accesskey> -sk <secretkey> ..."

This launcher provides an overview, usage examples, and links to documentation when launched via the XFCE app menu.

How to Use or Create a Launcher

  1. Write a bash/zsh launcher script that: - Prints a description, usage, examples, and references. - Runs the main tool if desired.

  2. Place it in the appropriate tool directory: - For Example: /opt/aws_tools/<tool>/<tool>_launcher.sh

💡 Pro Tip: You can explore and download all launchers from this GitHub directory: 🔗 https://github.com/pwnedlabs/pwncloudos/tree/main/docs/configs/launchers

Custom Launcher Files

All custom launchers in PWNCLOUDOS are .desktop files created using menulibre to integrate security tools into the XFCE menu system.

Each launcher runs a preconfigured bash script for that tool, located in /opt/…, making it easy for users to access complex cloud tools via a single click.

Location in PWNCLOUDOS: ~/.local/share/applications/

This is where all custom .desktop files are stored and where new ones should be copied.

📁 GitHub Directory: docs/configs/launchers/custom/ 🔗 View on GitHub

How to Use:

To activate these launchers in your PWNCLOUDOS system:

mkdir -p ~/.local/share/applications/
cp menulibre-*.desktop ~/.local/share/applications/

XFCE will auto-detect these entries and populate them in the Application Menu.

Example Files:

  • menulibre-awesomeuserfinder.desktop – Runs AWeSomeUserFinder for AWS IAM enum

  • menulibre-azurehound.desktop – Azure recon tool with graphical interface

  • menulibre-prowler.desktop – AWS auditing via CLI

  • menulibre-burpsuit-community.desktop – BurpSuite Community Edition

Sample .desktop Entry

[Desktop Entry]
Version=1.0
Name=AWeSomeUserFinder
Exec=/opt/aws_tools/AWeSomeUserFinder/awesome_userfinder_launcher.sh
Icon=utilities-terminal
Terminal=true
Type=Application
Categories=Security;AWS;

📥 [Download All Launchers (ZIP)](https://github.com/pwnedlabs/pwncloudos/archive/refs/heads/main.zip)