Project overview · Terminal previews
Start with installation, then choose a guide for the task you want to do.
| Guide | What you will find |
|---|---|
| Installation and migration | Supported systems, prerequisites, first install, file locations, default shell, migration |
| Terminal commands | Keyboard shortcuts, Alt+X command picker, navigation, tmux, ports and local servers |
| Developer workflow | Project checks, browser testing, language and container shortcuts, private commands |
| Included tools | Installed tools, Vite+, uv, version pinning, optional previews |
| Themes and customization | Theme switching, shared configuration, private device settings, repository layout |
| PostgreSQL manager | Connection discovery, database/schema actions, confirmations, recovery |
| Uninstall and recovery | Selective removal, retained programs, caches, backups and login-shell protection |
| Troubleshooting | Downloads, missing libraries, completion, and known platform issues |
| Development and maintenance | Tests, isolated install lifecycle checks, lockfile updates, publishing |
| Preview gallery | Theme and picker images, sample data, how to regenerate the assets |
| Change | Location |
|---|---|
| Shared aliases | config/zsh/aliases.zsh |
| Shell functions | config/zsh/functions.zsh |
| Alt+X picker | config/zsh/command-picker.zsh, scripts/command_catalog.py |
| Prompt themes | config/oh-my-posh/ |
| Portable commands | bin/ and scripts/ |
| Tool versions and checksums | tools.lock.json |
| Private settings | ~/.config/linux-setup-local/zshrc and zshenv on your device |
Keep credentials, machine-specific paths, and real project environment files out of the checkout. Follow development guidance when contributing.