Shell Guide

Setup, everyday workflows, and the details behind your commands.

Open Shell GuideOpen Shell GuideOpen Installation and RequirementsOpen Installation and RequirementsOpen Installation and RequirementsOpen Installation and RequirementsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Shell BasicsOpen Navigation and FindersOpen Navigation and FindersOpen Navigation and FindersOpen Navigation and FindersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Command Discovery and HelpersOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Package WorkflowsOpen Nix Profiles and PickersOpen Nix Profiles and PickersOpen Nix Profiles and PickersOpen Nix Profiles and PickersOpen CredentialsOpen CredentialsOpen CredentialsOpen CredentialsOpen Themes and Terminal OutputOpen Themes and Terminal OutputOpen Themes and Terminal OutputOpen Themes and Terminal OutputOpen Themes and Terminal OutputOpen Gotchas and SafetyOpen Maintenance and VerificationOpen Maintenance and VerificationOpen Maintenance and VerificationOpen Maintenance and VerificationOpen Maintenance and Verification

Guide search is loading. Browse the topics below.

This is the complete user and maintainer reference for the shared configuration in ~/.config/zsh. For the shortest setup path, start with README.md. When documentation and code disagree, the module files are authoritative.

The configuration is a GNU/Linux-focused layer that is sourced by a machine-local ~/.zshrc. Oh My Zsh, Starship, PATH setup, compinit, and host-specific choices remain outside this repository.

Explore the Guide

10 topics

Installation and Requirements

Set up your shell and check the tools it needs.

Shell Basics

History, completion, aliases, and everyday shortcuts.

Navigation and Finders

Move between directories and make the most of fzf.

Command Discovery and Helpers

Find commands and learn the helpers behind them.

Package Workflows

Check, search, upgrade, and clean with upkg.

Nix Profiles and Pickers

Manage profiles, select packages, and compare outputs.

Credentials

Store and load shell credentials with cgm.

Themes and Terminal Output

Choose colors, glyphs, and finder layouts.

Gotchas and Safety

Understand the boundaries before changing shell state.

Maintenance and Verification

Explore the modules and verify changes to the config.