Skip to content

Latest commit

 

History

History
33 lines (27 loc) · 2.19 KB

README.md

File metadata and controls

33 lines (27 loc) · 2.19 KB

Documentation

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

Where to make a change

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.