"Excess in all things - especially shell configuration"

A portable bash environment installer touched by the Dark Prince. Deploy your meticulously crafted shell across the Imperium's countless server worlds, from the forge worlds of RHEL to the hive cities of Debian.

⚠️ Manifesto: This unholy creation was wrought entirely by cogitators (AI-assisted development). The Machine Spirit has been consulted, and it is pleased.

Your shell environment, perfected through obsessive customization, deserves to follow you across every server you touch. This installer delivers:

• bash-it - The framework that binds all
• ble.sh - Syntax highlighting that makes your terminal weep with beauty
  • Auto-suggestions whispered from the warp
  • Vim modes for the initiated
  • Enhanced completion beyond mortal comprehension
• fzf - Fuzzy finding through the immaterium of your command history
• zoxide - Instant teleportation between directories
• pyenv - Python version sorcery
• goenv - Go version manipulation
• thefuck - Command correction through sheer indignation
• nano-syntax-highlighting - Syntax highlighting for the nano editor (for those who embrace heresy over vim)

Modern replacements for rusty Imperial utilities, installed to user space (~/.local/bin):

• bat - cat reborn with syntax highlighting (aliased as cat)
• ripgrep - Grep reforged in Rust, blazingly fast
• fd - find freed from decrepit syntax
• eza - ls ascended with colors and Git awareness
• sd - sed liberated from escape sequences
• jq - JSON interrogation with surgical precision
• jc - Convert CLI output to JSON (150+ commands)
• lazygit - Git's complexity rendered visual
• atac - Terminal API client (Postman-like, no account required)

• rustup - The Rust toolchain installer
• nvm - Node Version Manager
• pipx - Isolated Python CLI tool installation

• bashhub - Command history stored in the cloud (requires ritual authentication)

Embrace the simplest corruption - a single incantation:

curl -fsSL https://raw.githubusercontent.com/DaiTengu/slaane.sh/master/slaane.sh | bash -s -- install --install-prereqs

This downloads the repository, installs prerequisites, and corrupts your shell environment in one glorious command.

For those who prefer deliberate corruption:

# Summon the repository
git clone https://github.com/DaiTengu/slaane.sh.git ~/slaane.sh
cd ~/slaane.sh

# Invoke the installer
./slaane.sh install

After the ritual completes:

# Reload your shell to embrace the changes
reload  # Function provided by slaane.sh

# Or manually source
source ~/.bashrc

# Or summon a fresh shell entirely
exec bash

The slaane.sh command is now available system-wide from ~/.local/bin/slaane.sh.

Once installed, slaane.sh is available globally. Customize your corruption:

Standard Corruption - All core components:

slaane.sh install

Minimal Devotion - Only bash-it, ble.sh, and fzf:

slaane.sh install --minimal

Skip Certain Gifts - Reject specific modules:

slaane.sh install --skip=goenv,thefuck

Embrace Bashhub - Include bashhub (requires account):

slaane.sh install --with-bashhub

System-Wide Corruption - Invoke the machine's overseers (requires sudo):

slaane.sh install --global

User-Space Only - No sudo prompts, install everything locally:

slaane.sh install --local

Force Local - Install local version even if tool exists system-wide:

slaane.sh install --force-local

Install Specific Module - Target a single tool:

slaane.sh install --module bat --local
slaane.sh install --module lazygit

Install All Modules - Mass summoning (skips interactive modules):

slaane.sh install --module all --local

Force Reinstallation - Purge and rebuild:

slaane.sh install --force

Note: The --install-prereqs flag is only needed for manual installations. The recommended curl method includes it automatically.

The installer demands these tools be present (or will install them with --install-prereqs):

• git - To pull from the repository vaults
• curl - To reach across the network
• make - To build from source
• gawk - GNU Awk, required by ble.sh

The Dark Prince's gifts require no sacrifice of privilege:

• Modules (fzf, zoxide, thefuck, pyenv, goenv) corrupt only your personal domain
• Prerequisites (git, curl, make, gawk) may demand elevated rites if absent
• The installer seeks your blessing before invoking sudo (unless --install-prereqs or --global compels it)
• The --global flag summons system-wide installations through your machine's package overseer (requires sudo)

Note: A C compiler is only needed if you seek to forge Python versions via pyenv install (not required for the base corruption).

Debian/Ubuntu (Hive Worlds):

sudo apt-get update && sudo apt-get install -y git curl make gawk

RHEL/CentOS/Fedora/Rocky (Forge Worlds):

sudo dnf install -y git curl make gawk

Arch Linux (Chaos Undivided):

sudo pacman -S git curl make gawk

Note: If you plan to install Python versions via pyenv install, you'll also need build tools. See the "pyenv Build Failures" section below.

Or submit to the installer's will:

slaane.sh install --install-prereqs

# Package the corruption
cd ~
tar czf slaane.sh.tar.gz slaane.sh/

# Transfer to remote server
scp slaane.sh.tar.gz user@remote:~/

# On the remote server
ssh user@remote
tar xzf slaane.sh.tar.gz
cd slaane.sh
./slaane.sh install

ssh user@remote
git clone https://github.com/DaiTengu/slaane.sh.git ~/slaane.sh
cd ~/slaane.sh
./slaane.sh install --install-prereqs

The quickest path to perfection:

ssh user@remote 'curl -fsSL https://raw.githubusercontent.com/DaiTengu/slaane.sh/master/slaane.sh | bash -s -- install --install-prereqs'

One command to download, corrupt, and perfect the remote shell.

• ~/.bashrc - The primary grimoire (installed from config/bashrc.template)
• ~/.blerc - ble.sh incantations (1307 lines of obsessive configuration)
• ~/.bashrc.local - Your personal heresies (not overwritten)

Edit config/bash-it-components to modify which bash-it components are enabled:

# config/bash-it-components
[alias]
git
docker
# ... your preferences

[plugin]
git
fzf
# ... your preferences

[completion]
git
docker
# ... your preferences

Heretical Modification: The installer corrupts bash-it's default liquidprompt.theme.bash, replacing it with a corrected version that properly manifests git branch names in the prompt. The original theme's _lp_git_branch() function failed to bind the branch variable, leaving only status symbols visible to the uninitiated.

Create ~/.bashrc.local for server-specific incantations:

# ~/.bashrc.local
export HERESY="acceptable"
alias my_ritual='echo "The Emperor protects... from bad shell configs"'

Watch as your commands shimmer with color, distinguishing the valid from the profane.

The shell whispers completions from your history. Press Shift+Right to accept its counsel.

• Ctrl+R - Dive into the warp of command history
• Ctrl+T - Summon files from the void
• Alt+C - Teleport between directories

# Jump to frequently visited realms
z documents
z my-project
z ~

# Survey your domains
zoxide query -l

# List available Python versions
pyenv install --list

# Install a specific version
pyenv install 3.11.0

# Set your global Python
pyenv global 3.11.0

# Set project-specific Python
cd my-project
pyenv local 3.9.0

# List available Go versions
goenv install --list

# Install a version
goenv install 1.21.0

# Set global version
goenv global 1.21.0

When you inevitably stumble:

$ gti status
$ fuck
# Corrects to: git status

For the heretics who prefer nano over vim, syntax highlighting is automatically installed:

# Open any file and witness syntax highlighting
nano script.sh
nano config.yaml
nano Dockerfile

# The highlighting works automatically - no configuration needed
# Files are installed to ~/.nano/

Note: If nano is not installed, the syntax files are still installed and will activate once nano is installed. Use --install-prereqs to automatically install nano during setup.

The installer adapts to your machine's architecture like a daemon to its host:

• x86_64 (Standard Imperial)
• aarch64 (ARM 64-bit - Adeptus Mechanicus approved)
• armv7l (ARM 32-bit)
• Other architectures (falls back to source compilation)

Tested across the following Imperial/Chaos sectors:

• Debian/Ubuntu - Hive worlds (apt)
• RHEL/CentOS/Fedora/Rocky/AlmaLinux - Forge worlds (dnf/yum)
• Arch Linux - Chaos undivided (pacman)
• Gentoo - The truly damned (emerge)

Auto-detects your distribution and package manager. The Omnissiah provides.

If the installer balks at missing tools:

# Option 1: Manual propitiation
# (see Prerequisites section above)

# Option 2: Let the installer claim what it needs
./slaane.sh install --install-prereqs

Ensure bash-it loads properly and the blesh plugin is enabled:

bash-it enable plugin blesh
source ~/.bashrc

Integration with ble.sh flows through bash-it's blesh plugin. Verify both are enabled:

bash-it show plugin | grep -E "(fzf|blesh)"

The forge requires proper materials. Install build dependencies:

Debian/Ubuntu:

sudo apt-get install -y build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl git \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev

RHEL/Fedora:

sudo dnf install -y gcc make patch zlib-devel bzip2 bzip2-devel \
readline-devel sqlite sqlite-devel openssl-devel tk-devel \
libffi-devel xz-devel

The installer auto-enables EPEL. If it fails, manually enable:

sudo dnf install -y epel-release
sudo dnf install -y zoxide

# Survey bash-it's domain
bash-it show aliases
bash-it show plugins
bash-it show completions

# Check the ble.sh possession
echo $BLE_VERSION

# Verify the other tools
fzf --version
zoxide --version
pyenv --version
goenv --version
thefuck --version

# Check nano syntax highlighting (for the heretics)
ls ~/.nano/*.nanorc 2>/dev/null | wc -l  # Count of syntax files

slaane.sh/
├── slaane.sh              # The master script (install, update, uninstall, list, test)
├── lib/
│   ├── common.sh          # Common incantations (OS detection, logging)
│   ├── modules.sh         # Module discovery and installation handlers
│   └── install-helpers.sh # GitHub binary and pipx installation helpers
├── modules/               # Each module is a simple declarative script
│   ├── bash-it.sh         # bash-it summoner (core)
│   ├── blesh.sh           # ble.sh manifestation (core)
│   ├── fzf.sh             # fzf invocation (core)
│   ├── bat.sh             # bat (cat replacement)
│   ├── ripgrep.sh         # ripgrep (grep replacement)
│   ├── fd.sh              # fd (find replacement)
│   ├── eza.sh             # eza (ls replacement)
│   ├── jq.sh              # jq (JSON processor)
│   ├── lazygit.sh         # lazygit (Git TUI)
│   ├── atac.sh            # atac (API client TUI)
│   ├── rustup.sh          # Rust toolchain
│   ├── nvm.sh             # Node version manager
│   ├── zoxide.sh          # zoxide conjuration
│   ├── pyenv.sh           # pyenv binding
│   ├── goenv.sh           # goenv rite
│   ├── thefuck.sh         # thefuck channeling
│   ├── nano.sh            # nano syntax highlighting
│   └── bashhub.sh         # bashhub pact (optional)
├── config/
│   ├── bashrc.template        # Template grimoire
│   ├── blerc                  # ble.sh tome
│   ├── bash-it-components     # List of enabled blessings
│   ├── slaane.bash-completion # Tab completion for slaane.sh
│   └── liquidprompt.theme.bash # Corrupted liquidprompt theme
├── docs/
│   └── MODULE_API.md          # Module creation guide
├── test.sh                # Verification ritual
├── test-docker.sh         # Multi-realm testing
├── TESTING.md             # Testing doctrine
├── CHANGELOG.md           # Annals of corruption
├── TODO.md                # The unfinished grimoire
└── README.md              # This scripture

For those who seek deeper knowledge of this unholy creation:

• CHANGELOG.md - The annals of corruption, documenting all changes as the project evolves through the warp
• TODO.md - The unfinished grimoire, cataloging future enhancements and banishment rites yet to be perfected

Should you wish to purge the Dark Prince's gifts from your system:

# Banish all modules and restore your shell
slaane.sh uninstall --module all

# Nuclear option: remove everything including slaane.sh itself
slaane.sh uninstall --purge

# The ritual removes:
# - All installed modules (~/.bash_it, ~/.local/share/blesh, ~/.fzf, etc.)
# - The slaane.sh symlink from ~/.local/bin
# - Restores your original ~/.bashrc from ~/.bashrc.pre-slaanesh

# Remove specific modules only
slaane.sh uninstall --module bash-it
slaane.sh uninstall --module pyenv,goenv

# List what's currently bound to your system
slaane.sh list --installed

Should the automated banishment fail:

# Restore your original shell
cp ~/.bashrc.pre-slaanesh ~/.bashrc

# Remove the repository
rm -rf ~/slaane.sh

# Remove installed components
rm -rf ~/.bash_it ~/.local/share/blesh ~/.fzf ~/.pyenv ~/.goenv
rm -f ~/.blerc ~/.local/bin/slaane.sh

# Remove pip/cargo packages if desired
pip3 uninstall -y thefuck

See TESTING.md for the complete testing doctrine.

Quick verification on Rocky Linux 9:

./test-docker.sh --distro rockylinux:9

Primary test target:

• ✅ Rocky Linux 9

• Report bugs
• Suggest improvements
• Submit pull requests
• Share your own heresies

This project orchestrates the installation of various open-source tools, each bound by their own licenses:

• bash-it: MIT
• ble.sh: BSD-3-Clause
• fzf: MIT
• zoxide: MIT
• pyenv: MIT
• goenv: MIT
• thefuck: MIT

All glory to the original creators of these magnificent tools. This installer merely serves as a conduit for their power.

Special thanks to:

• The Machine Spirit for guidance
• Claude (Cogitator-class AI) for manifestation of this code
• The Chaos Gods for inspiration

This project is licensed under the MIT License - see the LICENSE file for details.

"To comprehend the true nature of this shell configuration is to court madness. The initiated know that perfection of one's terminal environment is a path from which there is no return."

For issues, questions, or to report possession by rogue shell scripts:

• Open an issue: https://github.com/DaiTengu/slaane.sh/issues
• Check TESTING.md for verification rituals
• Consult the individual tool documentation for deeper mysteries

The Emperor Protects… but Slaane.sh Perfects.