gladeshell Official Documentation

Everything you need to master, install, customize, and extend gladeshell — the production-ready shell setup built for modern developers across Linux, macOS, and Windows.

✓ Version 2.0 Stable ⚡ Zero Dependencies 🛡️ Safe Boundary Installer Shells: Bash • Zsh • Fish • PowerShell License: MIT

🚀 Overview & Philosophy

gladeshell is a lightweight, opinionated terminal enhancement environment engineered specifically for full-stack, DevOps, and open-source developers. Unlike heavy framework monoliths (such as Oh My Zsh or bulky plugin managers), gladeshell operates with zero external script dependencies, instant terminal cold startup (< 15ms), and a safe single-file modular architecture.

💡 Core Architecture Guarantee

gladeshell never modifies your core system bin files or destroys existing shell configurations. All additions are injected cleanly between boundary comments (`# >>> glade-bashrc >>>` and `# <<< glade-bashrc <<<`).

System Requirements

gladeshell works natively across virtually any modern Unix or Windows system:

Platform / OS	Supported Shells	Minimum Required Tools	Recommended Enhancements
Linux (Ubuntu, Debian, Arch, Fedora, Alpine)	Bash 4.4+, Zsh 5.8+, Fish 3.0+	`curl`, `git`, `bash`	`fonts-noto-color-emoji`, `fzf`, `gum`
macOS (Sequoia, Sonoma, Ventura)	Zsh (Default), Bash (Homebrew), Fish	`curl`, `git`	Fira Code Nerd Font, iTerm2 / Ghostty
Windows 10/11 (Native & WSL2)	PowerShell 7+, Windows PowerShell 5.1, WSL2 Bash	`curl` / `irm`	Windows Terminal, Cascadia Code PL

Universal 1-Line Installer

The smartest way to set up gladeshell. It automatically detects your operating system and current default shell, injecting the appropriate configuration cleanly:

Bash / Zsh (Universal)

curl -fsSL https://gladeshell.netlify.app/install.sh | bash

PowerShell (Windows Universal)

powershell -c "irm https://gladeshell.netlify.app/install.ps1 | iex"

Shell-Specific Installers

If you prefer targeting a specific shell directly, run the respective execution script:

Target Shell	Configuration Target File	One-Line Terminal Command
Bash	`~/.bashrc`	`bash <(curl -fsSL https://gladeshell.netlify.app/public/install.sh)`
Zsh	`~/.zshrc`	`zsh <(curl -fsSL https://gladeshell.netlify.app/public/install.zsh)`
Fish	`~/.config/fish/config.fish`	`fish <(curl -fsSL https://gladeshell.netlify.app/public/install.fish)`
PowerShell	`$PROFILE`	`powershell -c "irm https://gladeshell.netlify.app/install.ps1 \| iex"`

Manual Clone & Source

For air-gapped environments or manual dotfile management, clone the repository directly:

Shell Script

# 1. Clone gladeshell repository
git clone https://github.com/rihadjahanopu/gladeshell.git
cd gladeshell

# 2. Append configuration for Bash
cat config.sh >> ~/.bashrc
source ~/.bashrc

# Or for Zsh
cat config.zsh >> ~/.zshrc
source ~/.zshrc

# Or for Fish
cat config.fish >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

Verification & First Steps

Once installed, reload your active shell or type:

Bash

source ~/.bashrc  # Or restart your terminal window

You should immediately see the glowing rainbow prompt with directory-aware emojis (e.g. 🌐 for web projects, 🟢 for Node.js, 🐍 for Python)!

Updating & Uninstalling

To upgrade gladeshell to the latest version and automatically reload your shell, run:

Gladeshell Auto-Upgrade

gladeshell upgrade  # Upgrades gladeshell & auto-reloads shell process

# Aliases:
glade update
glade_upgrade

To perform a full system update (OS packages, Flatpaks, Snaps, Bun & Node), run the mega updater:

Terminal

uup  # Upgrades OS packages, Flatpaks, Snaps & Bun

To cleanly uninstall gladeshell without affecting any of your custom shell aliases or scripts:

Universal Uninstaller

curl -fsSL https://gladeshell.netlify.app/u.sh | bash

🖥️ Zed IDE Settings Installer

Install a fully-configured settings.json for the Zed editor — works for both Flatpak and native Linux installations in one shot:

Zed Settings One-Line Installer

curl -fsSL https://gladeshell.netlify.app/public/zed/install-settings.sh | bash

What it does: Creates a timestamped backup of your existing settings, writes tuned settings.json (BlackFox theme, Cascadia Code 22px font, Tab size 2, Prettier, Git inline blame, autosave) to both ~/.config/zed/ and Flatpak dev.zed.Zed config paths.

🐚 Shell Integration Guides

Zsh Setup & Zero-Framework Plugin Integration

gladeshell (`config.zsh`) provides supercharged Zsh integration with automatic autosuggestions and syntax highlighting, without requiring heavy frameworks like Oh-My-Zsh.

Zsh Plugin Setup Script

# 1. Create native Zsh plugin directory
mkdir -p ~/.zsh

# 2. Clone syntax highlighting and autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ~/.zsh/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-autosuggestions.git ~/.zsh/zsh-autosuggestions

# 3. Reload Zsh
source ~/.zshrc

Fish Shell Integration

For Fish shell users, `config.fish` maps all gladeshell function aliases to native Fish functions with complete tab auto-completion:

Fish Shell

# Install gladefish
fish <(curl -fsSL https://gladeshell.netlify.app/public/install.fish)
source ~/.config/fish/config.fish

PowerShell Setup ($PROFILE)

PowerShell 7+ and Windows PowerShell 5.1 are fully supported via `install.ps1`.

⚠️ Windows Script Execution Policy

If PowerShell blocks remote script execution, enable execution policy first in an Administrator terminal: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Font & Emoji Setup

To render color emojis and programming ligatures in Linux terminals, install Noto Color Emoji and Fira Code:

Ubuntu / Debian Font Install

sudo apt update && sudo apt install -y fonts-noto-color-emoji fonts-firacode fonts-cascadia-code
fc-cache -fv

Priority configuration for /etc/fonts/local.conf:

XML Config (/etc/fonts/local.conf)

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <alias>
    <family>monospace</family>
    <prefer>
      <family>Fira Code</family>
      <family>Noto Color Emoji</family>
    </prefer>
  </alias>
</fontconfig>

📟 Smart Prompt System

gladeshell features a two-line contextual prompt that adapts to your active workspace, system hardware status, and git repositories in real-time.

Folder Emojis & Status Indicators

The prompt automatically detects project indicator files inside your working directory:

Detected File / Environment	Prompt Emoji	Description
`package.json` / `node_modules`	🟢	Node.js Web / Backend Project
`bun.lockb` / `bunfig.toml`	🥐	Bun JavaScript / TypeScript Runtime
`requirements.txt` / `Pipfile` / `pyproject.toml`	🐍	Python Application Environment
`index.html` / `vite.config.js`	🌐	Frontend Web Application
`Dockerfile` / `docker-compose.yml`	🐳	Docker Containerized Project
`Cargo.toml`	🦀	Rust Cargo Package
`go.mod`	🐹	Go Module Workspace
Read-only directory	🔒	Directory lacks write permissions

CPU Temp & System Monitoring

Real-time system health metrics rendered directly in the prompt bar:

CPU Temperature: Color coded — 🟢 Green (< 65°C), 🟡 Yellow (65–80°C), 🔴 Red (> 80°C).
Git Dirty Branch: Shows branchname ❗ when uncommitted changes exist.
Command Execution Timer: Shows ⏱️ Ns for any command taking longer than 1.0s.

Customizing Prompt Behavior

You can toggle individual prompt monitors by exporting environment variables in your .bashrc / .zshrc:

Bash Config

# Custom gladeshell environment variables
export GLADE_SHOW_CPU_TEMP=true     # Show CPU temp
export GLADE_SHOW_GIT_DIRTY=true    # Show git dirty status
export GLADE_SHOW_EXEC_TIMER=true   # Show command duration

🎨 Prompt Themes Gallery

gladeshell ships with 55 world-class prompt themes inspired by the best designs from Oh My Zsh, Oh My Posh, Starship, Spaceship, and modern terminal aesthetics. Every theme works across Bash, Zsh, and Fish shells with full color and emoji support.

💡 Tip: All themes support Git branch tracking, exit code indicators, and live system metrics. Use glade preview to browse them all interactively in a scrollable gallery right inside your terminal!

The `glade preview` Command

Run glade preview to open an interactive, scrollable theme gallery showing all 55 themes with live prompt rendering:

Terminal

# Open interactive scrollable theme gallery (all 55 themes)
glade preview

# Aliases — all do the same thing
glade list
glade_theme preview

glade preview — Theme Gallery

❯ glade preview

🎨 GLADESHELL PROMPT THEME GALLERY (55 Themes)

──────────────────────────────────────────────────────────

📌 [1/55] agnoster

💻 user@pc myproject [🌿 main ❗] ❯

──────────────────────────────────────────────────────────

📌 [2/55] bira

╭─user@pc ~/myproject [🌿 main ❗]

╰─$

... scroll with ↑↓ or PageUp/PageDown to see all 55 themes ...

Press q to exit gallery

Switching Themes

Use the glade command to switch themes interactively or directly by name:

Terminal

# Open interactive gum/fzf theme picker (arrow keys to select)
glade

# Switch to a specific theme directly by name
glade catppuccin
glade tokyonight
glade dracula
glade cyberpunk
glade starship
glade matrix

# Theme persists across sessions — saved to ~/.gladeshell_theme

All 55 Themes Showcase

Every theme is available on Bash, Zsh, and Fish. Activate with glade <name>:

01 minimal

🌈 myproject
❯❯❯

Gladeshell default · Random emoji · 1-line

glade minimal

02 full

🚀 myproject 📂 20M [🌿 main] 🌡️35°C
🟢 v24 │ bun │ Aug 25
❯❯❯

Full 3-line · All system metrics · Git + Node

glade full

03 robbyrussell

➜ myproject [🌿 main ❗] ❯

Oh My Zsh classic default · 1-line clean

glade robbyrussell

04 p10k

╭─ 🐧 user@pc in ~/myproject [🌿 main]
╰─❯

Powerlevel10k inspired · 2-line rich prompt

glade p10k

05 agnoster

💻 user@pc myproject main
❯

Oh My Zsh Powerline segment style

glade agnoster

06 catppuccin

🐱 catppuccin 📂 myproject [🌿 main]
❯❯❯

Oh My Posh · Soft pastel Mocha palette

glade catppuccin

07 tokyonight

🌌 ~/myproject [🌿 main] v24
⚡

Oh My Posh · Cyber neon Tokyo Night

glade tokyonight

08 dracula

🧛 user in ~/myproject [🌿 main]
❯

Oh My Posh · Vibrant dark pink/purple

glade dracula

09 nord

❄️ ~/myproject [🌿 main]
❯

Oh My Posh · Arctic frost calm palette

glade nord

10 bira

╭─user@pc ~/myproject [🌿 main]
╰─$

Oh My Zsh classic two-line style

glade bira

11 pure

~/myproject [🌿 main]
❯

Sindre Sorhus Pure · Ultra quiet minimal

glade pure

12 starship

🚀 user in ~/myproject [🌿 main]
❯

Starship cross-shell inspired · Rocket style

glade starship

13 cyberpunk

⚡ CYBER ~/myproject [🌿 main]
▶▶

Futuristic neon yellow & electric cyan

glade cyberpunk

14 synthwave

🌅 ~/myproject [🌿 main]
❯❯

80s retro magenta & electric purple vibes

glade synthwave

15 gruvbox

🌴 user in ~/myproject [🌿 main]
❯

Retro warm gold & forest green palette

glade gruvbox

16 onedark

🌐 user ~/myproject [🌿 main]
❯

Atom & VS Code One Dark · Classic blue

glade onedark

17 sorin

user@pc ~/myproject [🌿 main]
❯

Oh My Zsh Sorin · Modern clean arrow

glade sorin

18 spaceship

🚀 user in ~/myproject [🌿 main]
➜

Spaceship ZSH inspired · Iconic rocket

glade spaceship

19 halflife

λ ~/myproject [🌿 main]
▶

Half-Life scientist lambda · Warm orange

glade halflife

20 paradox

⚡ ~/myproject [🌿 main]
❯

Oh My Posh Paradox · Chevron powerline

glade paradox

21 bureau

[user@pc] ~/myproject [🌿 main]
❯

Oh My Zsh Bureau · Multi-line with brackets

glade bureau

22 gallifrey

⏳ ~/myproject [🌿 main]
❯

Sci-Fi TARDIS gold & deep cyan palette

glade gallifrey

23 material

💎 user ~/myproject [🌿 main]
❯

Google Material Design · Emerald & cyan

glade material

24 monokai

🔥 user in ~/myproject [🌿 main]
❯

Sublime/VS Code Monokai Pro neon

glade monokai

25 palenight

🍇 ~/myproject [🌿 main]
❯

Material Palenight · Purple lavender & pink

glade palenight

26 powerlineclassic

user@pc ~/myproject [🌿 main]
❯

Classic Powerline statusline style

glade powerlineclassic

27 lambda

λ ~/myproject [🌿 main] ❯

Oh My Zsh Lambda · Functional aesthetic

glade lambda

28 hyper

⚡ ~/myproject [🌿 main]
❯

Hyper Terminal lightning pink & cyan

glade hyper

29 slick

● myproject [🌿 main] ❯

Single-line ultra-slick dot indicator

glade slick

30 matrix

📟 user@pc:~/myproject [🌿 main]
[matrix]❯

Hacker glowing green Matrix terminal

glade matrix

31 sunset

🌇 ~/myproject [🌿 main]
❯

Coral pink & warm sunset orange palette

glade sunset

32 solarized

☀️ user in ~/myproject [🌿 main]
❯

Solarized Dark warm cyan & yellow retro prompt

glade solarized

33 rosepine

🌹 ~/myproject [🌿 main]
❯

Rosé Pine muted rose & lavender aesthetic

glade rosepine

34 everforest

🌲 user ~/myproject [🌿 main]
❯

Everforest deep forest green & warm amber

glade everforest

35 kanagawa

🌊 user in ~/myproject [🌿 main]
❯

Kanagawa Wave Japanese ink blue & dragon gold

glade kanagawa

36 nightowl

🦉 user ~/myproject [🌿 main]
❯

Night Owl midnight navy & vivid turquoise

glade nightowl

37 cobalt2

⚡ user in ~/myproject [🌿 main]
❯

Cobalt2 electric blue & bright yellow prompt

glade cobalt2

38 shadesofpurple

🍇 ~/myproject [🌿 main]
❯❯

Shades of Purple royal purple & glowing yellow

glade shadesofpurple

39 ayu

🎨 user ~/myproject [🌿 main]
❯

Ayu Dark clean orange & bright teal contrast

glade ayu

40 snazzy

✨ ~/myproject [🌿 main]
❯

Hyper Snazzy vivid magenta & electric cyan

glade snazzy

41 outrun

🌆 user in ~/myproject [🌿 main]
▶▶

Outrun 84 80s neon sunset pink & cyan

glade outrun

42 oceanic

🌊 ~/myproject [🌿 main]
❯

Oceanic Next deep sea cyan & coral red

glade oceanic

43 moonlight

🌙 user ~/myproject [🌿 main]
❯

Moonlight deep indigo & sky blue accent

glade moonlight

44 papercolor

📜 user@pc ~/myproject [🌿 main]
❯

PaperColor high contrast monochrome accent

glade papercolor

45 horizon

🌄 ~/myproject [🌿 main]
❯

Horizon Dark warm coral & peach sunset

glade horizon

46 catppuccin_frappe

☕ user in ~/myproject [🌿 main]
❯❯

Catppuccin Frappé cool muted pastel lavender

glade catppuccin_frappe

47 dracula_pro

🗡️ user ~/myproject [🌿 main]
▶

Dracula Pro neon violet & emerald blade

glade dracula_pro

48 cyber_samurai

🥷 user ~/myproject [🌿 main]
❯❯❯

Cyber Samurai crimson red & neon cyan edge

glade cyber_samurai

49 evergreen

🍃 ~/myproject [🌿 main]
❯

Evergreen fresh mint & leaf green prompt

glade evergreen

50 ghost

👻 user in ~/myproject [🌿 main]
❯

Ghost Shell translucent grey & phantom white

glade ghost

51 oxide

⚙️ ~/myproject [🌿 main]
❯

Oxide Rust burnt orange & copper tone

glade oxide

52 neon_pulse

🔮 user ~/myproject [🌿 main]
⚡

Neon Pulse vivid lime & electric pink prompt

glade neon_pulse

53 volcano

🌋 ~/myproject [🌿 main]
▶

Volcano Magma fiery red & obsidian obsidian

glade volcano

54 sakura

🌸 user in ~/myproject [🌿 main]
❯

Sakura Cherry blossom pink & pastel green

glade sakura

55 galaxy

🌌 user ~/myproject [🌿 main]
✨ ❯

Galaxy Nebula deep space indigo & purple

glade galaxy

⚡ Interactive Command Explorer

Search over 60 built-in developer aliases and commands instantly by name, category, or command expansion:

🛠️ Terminal Simulator

Click any quick command chip below to test how gladeshell executes interactive utilities live:

gladeshell terminal simulator v2.0 tty1

🚀 gladeshell ❯ System initialized. Click any chip below to simulate a command!

⚙️ Custom Installer & Config Builder

Tailor your installation script and custom environment flags:

1. Select Shell Target:

Bash (.bashrc) Zsh (.zshrc) Fish Shell PowerShell ($PROFILE)

2. Select Optional Features:

CPU Temp Alert Git Dirty Branch Bun Aliases Docker Suite Execution Timer

Generated Installation Command:

Tailored Installer Command

curl -fsSL https://gladeshell.netlify.app/public/install.sh | bash

Generated Environment Config Block:

Custom Config Flags

# gladeshell custom configuration

📂 Complete Command Reference

Every alias and command available in gladeshell — mirrored exactly from the home page. Not a single one is missing.

📂 Navigation & Movement

Command	Action
`..`	Go up one directory
`...`	Go up two directories
`....`	Go up three directories
`dev`	Jump to `~/Development`
`fr`	Jump to Frontend folder
`ba`	Jump to Backend folder
`fu`	Jump to Fullstack folder
`fig`	Jump to Figma folder
`ar`	Jump to Archive folder
`de`	Jump to Dev folder
`des`	Jump to Desktop
`doc`	Jump to Documents
`dow`	Jump to Downloads
`bv`	Jump to Brave Downloads (`~/Downloads/Brave`)
`ch`	Jump to Chrome Downloads (`~/Downloads/Chrome`)
`gp`	Jump to Google Photos Downloads
`pic`	Jump to Pictures
`vid`	Jump to Videos
`mus`	Jump to Music
`rd`	Jump to root directory (`/`)

📦 NPM & Bun Commands

Alias	Expands To
`ni`	`npm install`
`nid`	`npm install -D`
`nr`	`npm run`
`nrd`	`npm run dev`
`nrb`	`npm run build`
`nrs`	`npm run start`
`bi`	`bun install`
`br`	`bun run`
`brd`	`bun run dev`
`bhot`	`bun --hot`
`w`	`bun --watch`
`brb`	`bun run build`
`brs`	`bun run start`
`html`	`bun run index.html`

🌿 Git Version Control

Command	Description
`gi`	Initialize new git repository
`gs`	Git status (short format)
`ga`	Stage all files (`git add .`)
`gcm "msg"`	Commit with message
`gps`	Push to remote
`gpl`	Pull from remote
`gl`	Pretty git log with graph
`gco <branch>`	Checkout branch
`gcb <name>`	Create & checkout new branch
`gd`	View diff
`gst` / `gsta` / `gpop`	Stash / Apply stash / Pop stash
`gwip`	Quick WIP commit + auto push to current branch
`gc [URL]`	Git Clone project
`gbranch`	Interactive Git branch manager — sorted by most-recently-committed. Flags: `-l` local · `-r` remote · `-a` all · `-h` help

🌿 gbranch — Interactive Git Branch Manager Deep-Dive

Usage: gbranch [-l] [-r] [-a] [-h] — Replaces standard git branch with an interactive fuzzy branch manager. Branches are sorted by most recently committed.

Flags:

Flag	Description
`-l`, `--local`	Show local branches only
`-r`, `--remote`	Show remote branches only
`-a`, `--all`	Show all local and remote branches (default)
`-h`, `--help`	Print usage reference and keybindings

Interactive FZF Keybindings:

Keybinding	Action / Operation
`Enter`	Checkout selected branch (`git checkout`)
`Ctrl-D`	Delete local branch (`git branch -D`) with confirmation prompt
`Ctrl-R`	Rebase current branch onto selected (`git rebase`)
`Ctrl-O`	Merge selected branch into current (`git merge`)

Features: Live commit graph preview on the right (hash, author, date, subject). Smart remote checkout auto-strips origin/ prefix. Fallback chain: fzf → gum filter → numbered menu.

🔧 Project Initialization

Command	Description
`ii`	Interactive project init — choose Bun or NPM
`next`	Scaffold Next.js app via Bun or NPM
`vite`	Scaffold Vite project with optional Tailwind CSS v4
`ui`	Install & init Shadcn/UI with component selection
`css`	Auto-install Tailwind CSS + clsx + tailwind-merge
`run`	Interactive JS/TS file runner via Bun
`pg <file>`	Smart Universal Package Converter (.deb, .rpm, .tgz)
`makecpp`	Advance C/C++ boilerplate generator (auto cd, makefile, git, vscode)
`make run`	Compile and run the generated C/C++ project
`make clean`	Remove compiled binary file

⚙️ System & Maintenance

Command	Description
`uup`	Mega Updater — OS + Snap + Flatpak + Bun + Node.js via fzf
`uu`	Universal Uninstaller — fuzzy search across all package managers
`uc`	Universal system clean (cache, orphans, logs)
`update`	Update system packages
`clean`	Clean apt cache & remove orphaned packages
`setuppc`	Bootstrap a new PC with all essential developer tools
`rt`	Install Node.js (via nvm), Bun, and Deno
`ut`	Setup optimized CLI tooling for the PC
`rel`	Reload `.bashrc` configuration
`myip`	Show your public IP address
`iploc`	Show IP + city/region/org info via `ipinfo.io`
`ports`	List all open ports
`kp <port>`	Kill the process running on a given port
`serve`	Start a local Python HTTP server in current directory

🐳 Docker Container Suite

Command	Description
`dman`	🐳 Docker Desktop & DevOps Terminal Edition (interactive TUI dashboard)
`dstats`	Live realtime Docker resource usage dashboard
`dps`	List running containers (clean table format)
`dpsa`	List all containers (clean table format)
`sdps` / `sdpsa`	`sudo` versions of `dps` / `dpsa`
`sdi`	`sudo docker images`
`sdvl` / `sdnl`	`sudo` volume / network list
`sdsize` / `sdtop`	`sudo` disk usage / live stats
`di`	List all images
`dvl`	List all volumes
`dnl`	List all networks
`dsize`	Monitor Docker disk space
`dtop`	Monitor container stats
`dstop`	Stop a container
`drestart <name>`	Restart a container
`dkill`	Force kill a container
`drm`	Remove container
`drmi`	Remove image
`dstopall`	Stop all containers
`drmall`	Remove all containers
`dsh <name>`	Enter container terminal
`dlogs <name>`	Live tail container logs
`dbuild`	Build Docker image
`dbuild-nocache`	Build image without cache
`dhist <image>`	View image layer history
`dports <name>`	Check open port bindings of a container
`dcup`	Docker Compose up -d
`dcdn`	Docker Compose down
`dclogs`	Follow compose service logs
`dcupb`	Rebuild images and start services (`up -d --build`)
`dtest-ubuntu` / `dtest-node` / `dtest-alpine`	Quick test sandbox containers
`dfind <name>`	Search containers and images by name
`droot <name>`	Enter container as root user
`dip <name>`	Show container local IP address
`dwatch <name>`	Watch live file changes inside container
`dnetstat <name>`	Inspect active network connections inside container
`dtop-proc <name>`	Show process tree inside container
`dbackup <vol> <file>`	Backup Docker volume to .tar archive
`dkill-force`	Force kill all running containers with confirmation
`dclean`	Deep clean system (prune all unused resources with gum UI)
`dstart`	Start the Docker service (`systemctl start docker`)
`doff`	Stop the Docker service (`systemctl stop docker`)
`dstatus`	Check if Docker is running or stopped
`denable`	Enable Docker auto-start on boot
`ddisable`	Disable Docker auto-start on boot

🐘 PostgreSQL

Alias	Description
`pgstart`	Start the PostgreSQL service
`pgstop`	Stop the PostgreSQL service
`pgrestart`	Restart the PostgreSQL service
`pgstatus`	Check PostgreSQL service status
`pgenable`	Enable PostgreSQL auto-start on boot
`pgdisable`	Disable PostgreSQL auto-start on boot
`pglogs`	Follow the PostgreSQL log file live
`pgl`	Login as `postgres` user via psql
`pgdb <name>`	Connect to a specific database (`pgdb mydb`)
`pgls`	List all databases (`\l`)
`pgtables`	List all tables in current DB (`\dt`)
`pgdump <db>`	Dump / backup a database
`pgrestore <db>`	Restore a database from file
`pgusers`	List all users / roles (`\du`)
`pgsize`	Show size of each database
`pgver`	Show PostgreSQL version
`pgconn`	Show active connections count
`pgcreate <db>`	Create a new database
`pgdrop <db>`	Drop / delete a database

💎 Prisma ORM

Alias	Full Command	Description
🟢 Node / NPX Prisma — `np*`
`np`	`npx prisma`	Base Prisma CLI command
`npi`	`npx prisma init`	Initialize Prisma in project
`npg`	`npx prisma generate`	Generate Prisma Client
`nps`	`npx prisma studio`	Open Prisma Studio GUI
`npmd`	`npx prisma migrate dev`	Run dev migrations
`npmdn <name>`	`npx prisma migrate dev --name`	Run named migration
`npmr`	`npx prisma migrate reset`	Reset DB & re-run migrations
`npmdp`	`npx prisma migrate deploy`	Apply pending migrations in production
`npms`	`npx prisma migrate status`	Check migration status
`npdp`	`npx prisma db push`	Push schema state directly to DB
`npdl`	`npx prisma db pull`	Pull schema from DB (Introspect)
`npds`	`npx prisma db seed`	Seed database using seed script
`npf`	`npx prisma format`	Format schema.prisma file
`npv`	`npx prisma version`	Show Prisma CLI & engine version
🥐 Bun Prisma — `bp*`
`bp`	`bunx prisma`	Base Prisma CLI via Bun runner
`bpi`	`bunx prisma init`	Initialize Prisma via Bun
`bpg`	`bunx prisma generate`	Generate Prisma Client via Bun
`bps`	`bunx prisma studio`	Open Prisma Studio GUI via Bun
`bpmd`	`bunx prisma migrate dev`	Run dev migrations via Bun
`bpmdn <name>`	`bunx prisma migrate dev --name`	Run named migration via Bun
`bpmr`	`bunx prisma migrate reset`	Reset database via Bun
`bpmdp`	`bunx prisma migrate deploy`	Apply migrations in prod via Bun
`bpms`	`bunx prisma migrate status`	Check migration status via Bun
`bpdp`	`bunx prisma db push`	Push schema directly to DB via Bun
`bpdl`	`bunx prisma db pull`	Pull schema from DB via Bun
`bpds`	`bunx prisma db seed`	Seed database via Bun
`bpf`	`bunx prisma format`	Format schema.prisma file via Bun
`bpv`	`bunx prisma version`	Check Prisma version via Bun

🔨 Utility Tools

Command	Description	Example
`cf [dir]`	Dev Walk & Quick CD — live syntax preview (bat), image thumbnails (chafa), zoxide jump (CTRL-Z), video (CTRL-V), PDF (CTRL-P), code editor (CTRL-O), explorer (CTRL-E)	`cf .`
`mkd <name>`	Create directory and `cd` into it	`mkd my-app`
`t <file>`	Create a file with feedback	`t index.js`
`rmd <name>`	Force remove directory recursively	`rmd old-build`
`rmf <file>`	Remove file with confirmation	`rmf test.txt`
`rn [dir]`	Clean and bulk rename files in directory	`rn .`
`bak <file>`	Create a `.bak` backup copy	`bak .env`
`trash <file>`	Move file to system trash (safe delete)	`trash temp.log`
`ex <archive>`	Extract any archive format	`ex project.tar.gz`
`ff <name>`	Find file by name (skips `node_modules`)	`ff tsconfig`
`gen <len>`	Generate cryptographically secure secret key	`gen 32`
`h <word>`	Search command history	`h docker`
`to`	Open current directory in VS Code
`v`	Play video in terminal
`c` / `cls`	Clear the terminal screen
`gbranch`	Interactive Git branch manager — sorted by most-recently-committed. Flags: `-l` local · `-r` remote · `-a` all	`gbranch -l`
`fkill [query\|port]`	Advanced interactive process killer — sorted by CPU. Pre-filter by name or kill by port number	`fkill node` / `fkill 3000`
`fcd`	Fuzzy quick directory jump (fzf / gum)

⚡ cf — Dev Walk & Quick CD Keybindings & Live Preview

Usage: cf [directory] (Defaults to .) — Interactive fuzzy navigator and multimedia launcher with live preview.

FZF Interactive Keybindings:

Keybinding	Operation / Action
`ENTER`	Navigate into directory OR open file in default app/editor
`CTRL-Z`	Switch candidate list to System Frecent Directories (`zoxide`)
`CTRL-V`	Play selected video file with `v()` player
`CTRL-P`	Open selected PDF document in Browser
`CTRL-O`	Open file or directory in Code Editor (`code` / `cursor` / `nvim`)
`CTRL-E`	Open directory in GUI File Manager (Nautilus / Dolphin / Explorer)
`CTRL-Y`	Copy path to Clipboard (`wl-copy` / `xclip` / `pbcopy`)
`CTRL-H`	Navigate to Parent Directory (`..`) inside FZF

Live Preview Features:

📁 Directories: Interactive folder tree (eza / tree / ls), Git active branch & recent 3 commits.
📄 Code & Text: Colorized syntax-highlighted preview via bat / batcat.
🖼️ Images: High-resolution terminal thumbnail preview powered by chafa.
📦 Archives: Previews .zip, .tar.gz, .7z, .rar contents without extracting.
🎵 Audio & Video: Audio metadata preview (mediainfo) and video quick actions.

⚡ fkill — Advanced Interactive Process Killer Deep-Dive

Usage: fkill [query] [port_number] — Processes are sorted by CPU usage (highest first) so resource-hungry processes are instantly visible.

Arguments & Usage:

Argument	Description
(none)	Open all processes sorted by CPU descending
`fkill node`	Pre-filter process list to show only `node` processes
`fkill 3000`	Directly find and kill process running on port 3000 (via `ss` / `lsof`)

FZF Interactive Keybindings:

Keybinding	Action / Operation
`Tab`	Multi-select multiple processes at once
`Enter`	Soft kill selected process(es) (`SIGTERM` — graceful shutdown)
`Ctrl-X`	Force kill selected process(es) (`SIGKILL -9` — immediate)
`Ctrl-R`	Reload live process list without closing FZF

Process Type Badges:

[APP] User GUI Applications (Chrome, VS Code, Slack, Discord, Firefox, VLC, Zed, Spotify)
[SYS] System Services & Daemons (root, systemd, dbus)
[USR] User CLI, Scripts & Shell processes (node, python, npm, bash)

📋 Todo & Notes Manager

Command	Description	Example
📋 Todo Manager — `~/.todo_list.txt`
`todo`	Open interactive gum menu, or show numbered task list
`todo add "task"`	Add a new task directly as argument	`todo add "Buy milk"`
`todo add`	Add task via interactive prompt (gum / read)
`todo list`	Show all pending tasks with line numbers
`todo done`	Mark done — fzf picker → gum chooser → ask for number	`todo done 2`
`todo clear`	Clear all tasks from the list
`todo --help`	Show full usage reference
📝 Notes Manager — `~/.my_notes/`
`notes`	Browse all notes with fzf + live preview
`notes add`	Add a note — pick category, enter title, write content
`notes search`	Full-text search inside all notes (fzf + grep -F)	`notes search "docker"`
`notes find`	Alias for `notes search`
`notes --help`	Show full usage reference

🎬 FFmedia Suite — 24-in-1 FFmpeg Powerhouse

Command	Description	Options & Notes
`ffmedia`	Interactive 24-in-1 FFmpeg multimedia menu (gum / fzf / prompt)	Aliases: `ffstudio`, `fftool`
`ffmedia compress`	Compress video preserving quality (50%–80% size reduction)	CRF 23 / 28 / 32
`ffmedia trim`	Fast & Lossless video trim without re-encoding	Instant cut
`ffmedia concat`	Merge multiple video clips seamlessly into one file	Wildcard match
`ffmedia resolution`	Convert resolution (1080p/720p) or crop/blur to 9:16 Reels	Shorts & Reels
`ffmedia speed`	Slow Motion (0.25x–0.5x) or Time-lapse (2x–8x)	Video & Audio synced
`ffmedia rotate`	Rotate (90°/180°) or Flip horizontally/vertically	Mirroring & Transpose
`ffmedia watermark`	Apply image logo or custom text banner watermark	5 positions
`ffmedia grid`	Side-by-Side (2 videos) or 2×2 grid (4 videos) comparison	Reaction & Compare
`ffmedia audio-extract`	Extract audio to MP3, AAC, WAV, FLAC, M4A	Lossless / High quality
`ffmedia mute`	Strip audio stream completely from video	Instant stream mute
`ffmedia audio-replace`	Replace or mix background audio with existing video sound	Background score
`ffmedia loudness`	Loudness Normalization (–14 LUFS YouTube / –23 LUFS EBU)	EBU R128 standard
`ffmedia visualizer`	Generate Waveform or Frequency Spectrum video from audio	Neon wave / Spectrum
`ffmedia audio-speed`	Change audio playback speed while preserving voice pitch	atempo filter
`ffmedia snapshot`	Extract Ultra HD image frame (JPG/PNG) at exact timestamp	High-res frame
`ffmedia bulk-frames`	Bulk extract video frames as image sequence	fps interval
`ffmedia gif`	Render pro-quality ultra-sharp GIF using 2-pass palette	Lanczos palettegen
`ffmedia contact-sheet`	Generate 3×3 (9 snapshots) or 4×4 mosaic thumbnail grid image	Video preview grid
`ffmedia screen-record`	Record desktop screen + system audio straight from terminal	x11grab / avfoundation
`ffmedia subtitle-burn`	Hardcode .srt or .ass subtitle file into video stream	Permanent burn-in
`ffmedia subtitle-extract`	Extract embedded subtitle tracks from MKV/MP4 files	Subrip .srt export
`ffmedia privacy-clean`	Wipe EXIF, GPS location, camera settings, and editing history	Metadata removal
`ffmedia convert`	Convert video/audio format between MP4, MKV, WEBM, MOV, AVI	Universal format swap
`ffmedia batch`	Run bulk compression/conversion/metadata wiping on a folder	Batch automation

🔐 Hardened Multi-Vault Security Suite

Command	Description	Security Features & Notes
`vault`	Open interactive GUM/FZF multi-vault manager menu	Aliases: `secvault`, `fvault`, `glade_vault`
`vault lock [path]`	Encrypt directory with AES-256 PBKDF2 (500,000 iter) & shred original	Multi-pass secure shredding
`vault unlock [name]`	Decrypt vault directly into RAM (`/dev/shm`) & symlink to `$HOME`	RAM execution guard
`vault list`	List all encrypted vaults stored in `~/.secret_vaults`	File sizes & active status
`vault delete [name]`	Permanently shred encrypted vault file after password verification	Aliases: `vault remove`, `vault rm`
`vault config`	Configure Telegram Bot Token & Chat ID for instant alert notifications	Telegram Bot API
`vault --help`	Show complete multi-vault usage reference	Panic password & auto-relock details

🏗️ Architecture & Safety Specs

gladeshell is engineered with safety as its primary design principle. Every modification made to shell configs is protected by boundary markers and automatic backup snapshots.

⚡ Performance Benchmark

⚡ Shell Performance Deep-Dive · gladeshell v1.2 (October 9, 2026)

Real empirical measurements across shell environments — Starship, Oh My Posh, Oh My Zsh, Bash, Zsh, Fish, PowerShell, and GladeShell — captured on live hardware using Criterion micro-benchmarks, 50-iteration os.wait4 sub-millisecond process timers, and make bench-startup.

Linux x86_64 · Intel i5-1145G7 @ 2.60GHz Rust 1.98.1 · gladeshell v1.2.0 (Fat-LTO) Kernel 6.18.38-amd64-desktop GladeShell vs Starship vs Oh My Posh vs Oh My Zsh Criterion Micro-benches + 50-Iter os.wait4

⚡

GladeShell

11.4 µs

Core prompt (PS1) · 0 forks

⭐

Starship

2.40 ms

Rust modular binary · 210× slower

🎨

Oh My Posh

8.20 ms

Go runtime binary · 700× slower

🔴

Oh My Zsh

18.50 ms

Zsh script framework · 1,600× slower

Shell startup & hook sourcing overhead (cached init file) measured via make bench-startup 10-iteration suite and 50-iteration os.wait4 timing. GladeShell writes atomic cached hooks to ~/.gladeshell/cache/init.<shell>. Bars are scaled relative to worst performer (Oh My Zsh · 220 ms).

⚡ GladeShell (cached hook) 🏆

6.71 ms

⭐ Starship (init binary)

18.5 ms

🎨 Oh My Posh (init binary)

38.0 ms

😱 Oh My Zsh (default plugins)

220 ms

📊 Terminal Startup / Hook Sourcing · 4 Prompt Engines Compared

Benchmark 1: GladeShell Bash hook (cached) — 10 runs Time (mean ± σ): 6.71 ms ± 0.38 ms [Range: 5.90 ms … 7.41 ms · Zsh: 32.4 ms] Benchmark 2: Starship init binary exec — measured Time (mean ± σ): 18.5 ms ± 1.2 ms [Range: 18.5 ms … 32.0 ms] Benchmark 3: Oh My Posh init binary exec — measured Time (mean ± σ): 38.0 ms ± 2.4 ms [Range: 38.0 ms … 85.0 ms] Benchmark 4: Oh My Zsh default plugin suite — measured Time (mean ± σ): 220.0 ms · (180 ms – 450 ms range; unoptimized: 890 ms) Summary: GladeShell is 2.8× faster than Starship · 5.5× faster than Oh My Posh · 32.8× faster than Oh My Zsh

🔬 All startup times measured with 10 warm-up runs + 10 timed runs (make bench-startup) and 50-iteration os.wait4 sub-millisecond process measurements. GladeShell caches generated shell hooks atomically to ~/.gladeshell/cache/init.<shell>, bringing terminal open latency down to 6.71 ms in Bash and 32.4 ms in Zsh.

Core prompt render latency (Criterion empirical micro-benchmarks & live process timings). GladeShell uses a zero-heap-allocation stack buffer (PromptContext + [u8; 4096]) and pure Rust gix 0.88 git engine — zero subshell forks on every keypress.

⚡ GladeShell Core Engine 🏆

0.011 ms

⭐ Starship (Rust binary)

2.40 ms

🎨 Oh My Posh (Go binary)

8.20 ms

😱 Oh My Zsh (Zsh script)

18.50 ms

Native Rust Autocompletion & Highlighting vs Shell Plugins

zsh-syntax-highlighting script

~12.5 ms

zsh-autosuggestions script

~9.2 ms

⚡ GladeShell Native Plugins 🏆

~0.08 ms

⚡ Criterion empirical benchmarks measured: 11.38 µs pure theme, 13.51 µs default theme, and 14.41 µs dirty tree. In Git repositories, gix 0.88 with monorepo TTL cache evaluates branch and status in 4.79 µs (hit) / < 4.6 ms (miss), replacing external subshell forks. Warm fast-path process launch runs in 1.64 ms mean / 0.92 ms min.

RSS memory footprint after interactive shell is fully loaded. Measured via /usr/bin/time -v zsh -i -c exit 2>&1 | grep 'Maximum resident'. GladeShell has 0 mandatory plugin dependencies.

⚡ GladeShell (core / full binary) 🏆

3.9 MB / 14.7 MB

⭐ Starship

12.5 MB

🎨 Oh My Posh

18.5 MB

😱 Oh My Zsh (default plugins)

~55 MB – 100 MB

External binary subshell forks per prompt render

⚡ GladeShell

0 forks

⭐ Starship

1 binary

🎨 Oh My Posh

1 binary

😱 Oh My Zsh

3–8 forks

💾 GladeShell core prompt engine footprint is just ~3.9 MB RSS. Even with all 40+ arsenal tools, TUI engines, and compressors linked, total binary RSS is ≤ 14.7 MB. Oh My Zsh with git, nvm, docker, python, npm plugins active easily exceeds 55–100 MB RSS.

Legend — Performance Axes

GladeShell

Zero-Alloc · gix engine · 0 subshells
Starship

Rust modular binary · config-driven
Oh My Posh

Go binary runtime · JSON themes
Oh My Zsh

Pure Zsh scripts · heavy plugin suite

Axes: Startup Speed · Prompt Speed · Memory Efficiency · Feature Count · Theme Richness · Zero Overhead
All axes normalised 0–10. Higher = better.

Complete Metrics Matrix

Metric	⚡GladeShell	⭐Starship	🎨Oh My Posh	🔴Oh My Zsh
Language / Architecture	Rust (Zero-Alloc / gix) ⚡	Rust (Static Binary)	Go (Static Binary)	Zsh Scripting
Core Prompt Latency (PS1)	11.4 µs (0.011 ms) ⚡	2.40 ms – 8.50 ms	8.20 ms – 26.50 ms	18.50 ms – 95.00 ms
Warm Process Launch (prompt)	1.64 ms mean / 0.92 ms min ⚡	15.2 ms – 28.5 ms	35.0 ms – 72.0 ms	N/A (Pure script)
Terminal Startup / Hook Source	6.71 ms (Bash) / 32.4 ms (Zsh) ⚡	18.5 ms – 32.0 ms	38.0 ms – 85.0 ms	180 ms – 450 ms (220 ms avg)
Cold Init Generation	24 ms – 28 ms ⚡	12 ms – 25 ms	28 ms – 60 ms	N/A (Static files)
Git Status Overhead (gix)	4.8 µs cache / < 4.6 ms live ⚡	8.5 ms – 35.0 ms	15.0 ms – 55.0 ms	45.0 ms – 250.0 ms
Subshell Process Forks	0 (Pure Native Rust) ⚡	1 binary fork	1 binary fork	3 – 8 forks / prompt
Memory Footprint (RSS)	3.9 MB core / ≤ 14.7 MB full ⚡	12.5 MB	18.5 MB	~55 MB – 100 MB
Built-in Themes	55 built-in (pure, minimal, powerline) ⚡	Preset configs (~15)	100+ themes (JSON download)	150+ themes (git scripts)
Auto-LS Built-in	✅ Built-in (icons, git, zero-fork) ⚡	❌ Needs external plugin	❌ Needs external plugin	❌ Needs external plugin
Self-Healing Init Cache	✅ Atomic (~/.gladeshell/cache) ⚡	❌ Manual eval	❌ Manual eval	❌ Compinit only
Cross-Platform Support	✅ Linux · macOS · Windows · BSD ⚡	✅ Linux · macOS · Windows	✅ Linux · macOS · Windows	⚠️ Linux · macOS (Zsh only)
Installation (1-line)	✅ curl / irm (All shells) ⚡	✅ curl / brew / winget	✅ brew / winget	✅ curl (Zsh only)

Key Optimisation Techniques

⚡

Fast-Path CLI Dispatcher

Manual zero-allocation argument matcher in main.rs bypasses clap entirely for prompt, init, and auto-ls. Reduces process launch from ~53 ms → 1.64 ms mean (0.92 ms min).

🔒

Self-Healing Init Cache

Shell integration scripts are generated once and atomically written to ~/.gladeshell/cache/init.<shell>. Sourcing takes just 6.71 ms in Bash and 32.4 ms in Zsh.

🚀

Monorepo-Aware Git TTL Cache

Pure Rust gix 0.88 engine with per-repo-root caching and 1.5s / 5s TTL. Status discovery hits memory in 4.79 µs; live scans complete in < 4.6 ms with zero subshell forks.

⏩

Packed Binary IPC Protocol

Unix socket daemon communication uses [u32-LE len][payload] wire format, eliminating string parsing and newline scanning. Socket round-trip takes only ~0.08 ms.

🛡️

Stack-Allocated Byte Buffer

Prompt rendering operates on a pre-allocated [u8; 4096] buffer with zero heap allocations on the hot path. Delivers 11.4 µs (0.011 ms) core render latency.

🐟

Single-Pass compinit Caching

Guarded Zsh completion initialization with compinit -C -d ~/.zcompdump and 24h freshness check. Eliminates redundant completion rebuilds and saves ~150 ms per interactive session boot.

📋 All data measured on Intel Core i5-1145G7 @ 2.60GHz, 7.5 GB RAM, Linux Deepin 25 (Kernel 6.18.38). Hyperfine v1.18, 10 warmup + 10 timed runs. Oh My Zsh version 5.9 with default plugin set. Starship v1.20 on Zsh 5.9. Oh My Posh 24.8 on Zsh 5.9. All prompt engines tested on the same machine session, cold filesystem caches cleared between runs. Figures reproduced from BENCHMARK.md.

Troubleshooting & FAQ

❓ Emojis or icons display as broken rectangles?

This indicates your terminal emulator does not have an emoji fallback font installed. On Linux, run: sudo apt install fonts-noto-color-emoji && fc-cache -fv and restart your terminal.

❓ How do I revert to my original pre-gladeshell shell config?

The installer automatically creates a timestamped backup before touching your files. Check your home directory for files like ~/.bashrc.backup_YYYYMMDD_HHMMSS and copy it back over ~/.bashrc.

Contributing & License

gladeshell is free and open-source software licensed under the MIT License. Contributions, bug reports, and feature pull requests are warmly welcomed on the official GitHub repository!

🚀 Overview & Philosophy

System Requirements

Universal 1-Line Installer

Shell-Specific Installers

Manual Clone & Source

Verification & First Steps

Updating & Uninstalling

🖥️ Zed IDE Settings Installer

🐚 Shell Integration Guides

Zsh Setup & Zero-Framework Plugin Integration

Fish Shell Integration

PowerShell Setup ($PROFILE)

Font & Emoji Setup

📟 Smart Prompt System

Folder Emojis & Status Indicators

CPU Temp & System Monitoring

Customizing Prompt Behavior

🎨 Prompt Themes Gallery

The glade preview Command

Switching Themes

All 55 Themes Showcase

⚡ Interactive Command Explorer

🛠️ Terminal Simulator

⚙️ Custom Installer & Config Builder

1. Select Shell Target:

2. Select Optional Features:

Generated Installation Command:

Generated Environment Config Block:

📂 Complete Command Reference

📂 Navigation & Movement

📦 NPM & Bun Commands

🌿 Git Version Control

Flags:

Interactive FZF Keybindings:

🔧 Project Initialization

⚙️ System & Maintenance

🐳 Docker Container Suite

🐘 PostgreSQL

💎 Prisma ORM

🔨 Utility Tools

FZF Interactive Keybindings:

Live Preview Features:

Arguments & Usage:

FZF Interactive Keybindings:

Process Type Badges:

📋 Todo & Notes Manager

🎬 FFmedia Suite — 24-in-1 FFmpeg Powerhouse

🔐 Hardened Multi-Vault Security Suite

🏗️ Architecture & Safety Specs

⚡ Performance Benchmark

Troubleshooting & FAQ

Contributing & License

The `glade preview` Command