Ultra-minimalist, keyboard-driven Linux environment powered by Niri scrollable Wayland compositor and deterministic AI agent harnesses.
Overview • Stack & Architecture • Keybindings • Installation • Structure • License
Sovereign dotfiles is a curated, high-performance configuration designed for daily technical workflows, terminal-first productivity, and autonomous AI pair-programming. It ditches heavy desktop suites in favor of Niri (infinite horizontal scrolling tiling compositor) with lightweight Wayland utilities.
- 🪟 Scrollable Tiling: Infinite horizontal workspace organization via Niri.
- 🚀 Sub-millisecond Terminal: Foot client/server architecture and Ghostty integration.
- 🎨 Unified Aesthetic: High-contrast, dark-mode tuned palette across foot, nvim, fuzzel, and yambar.
- 🤖 AI Agent SSOT Harness: Pre-configured global rules (
.gemini/config/) enforcing compiler-gated integrity and inspection-first workflows. - 🛡️ Zero Bloat / YAGNI: Native tools prioritized over bulky abstractions.
| Component | Technology | Configuration Path |
|---|---|---|
| Compositor | Niri (Wayland) | .config/niri/config.kdl |
| Terminal | Foot / Ghostty | .config/foot/foot.ini, .config/ghostty/config |
| Shell | Zsh & Bash + Starship | .zshrc, .bashrc, .config/starship.toml |
| Editor | Neovim (NvChad base) | .config/nvim/ |
| Multiplexer | Tmux + TPM plugins | .config/tmux/tmux.conf |
| Launcher | Fuzzel / Tofi | .config/fuzzel/fuzzel.ini |
| Status Bar | Yambar | .config/yambar/config.yml |
| Notifications | Fnott | .config/fnott/fnott.ini |
| Lock Screen | Waylock / Swaylock | .config/swaylock/config |
| Monitoring | Btop & Fastfetch | .config/btop/, .config/fastfetch/ |
| Agent Harness | Antigravity AI Standards | .gemini/config/ |
| Shortcut | Action |
|---|---|
Super + Enter / Super + T |
Spawn Foot terminal client |
Super + D |
Application launcher (Tofi / Fuzzel) |
Super + V |
Clipboard history manager |
Super + H / J / K / L |
Focus Left / Down / Up / Right column |
Super + Shift + H / L |
Move focused column horizontally |
Super + Shift + C |
Close active window |
Super + F |
Toggle fullscreen |
Super + R |
Switch column preset width |
Super + Alt + L |
Screen lock (Waylock) |
Super + Shift + / |
Open live interactive hotkey overlay |
# Clone the repository
git clone https://github.com/zyekhabdul/dotfiles.git ~/dotfiles
cd ~/dotfiles
# Run automated symlink installer
chmod +x install.sh
./install.shNote: The installer automatically safeguards your current configurations by archiving them into
~/.dotfiles_backup_<timestamp>/before creating symlinks.
If you only want specific modules (e.g. Niri & Foot):
mkdir -p ~/.config/niri ~/.config/foot
ln -sf ~/dotfiles/.config/niri/config.kdl ~/.config/niri/config.kdl
ln -sf ~/dotfiles/.config/foot/foot.ini ~/.config/foot/foot.inidotfiles/
├── .config/
│ ├── btop/ # Resource monitor tuning
│ ├── fastfetch/ # System profile fetch branding
│ ├── fnott/ # Minimalist notification daemon
│ ├── foot/ # Ultra-fast Wayland terminal config
│ ├── fuzzel/ # Lightweight app launcher
│ ├── ghostty/ # Modern GPU terminal backup
│ ├── niri/ # Master Wayland scrollable tiling layout
│ ├── nvim/ # Neovim configuration suite
│ ├── tmux/ # Session management & status bar
│ └── yambar/ # Wayland status bar blocks
├── .gemini/config/ # Deterministic AI agent global governance rules
├── .bashrc # Optimized Bash environment
├── .zshrc # Interactive Zsh configuration
├── .gitconfig # Git global defaults (SSH protocol enforcement)
├── install.sh # One-click backup & symlink deployment
├── LICENSE # MIT License
└── README.md # Documentation
Distributed under the MIT License. See LICENSE for details.
Developed & maintained by zyekhabdul.