Skip to content

Latest commit

 

History

History
83 lines (67 loc) · 4.17 KB

customization.md

File metadata and controls

83 lines (67 loc) · 4.17 KB

Customize your terminal setup

Documentation · Project overview

Switch the prompt theme

The default is quick-term. Both bundled themes are Oh My Posh configurations for Zsh; the iterm2 name does not require the iTerm2 application.

Theme Appearance Configuration
Quick-term Orange accents, two-line prompt, duration and clock, compact command history quick-term.omp.json
iTerm2 Blue and lime segments, exit-status color, rocket prompt, contextual segments iterm2.omp.json

Select any theme from the Oh My Posh theme gallery by setting its name in ~/.config/linux-setup-local/zshenv:

export LINUX_SETUP_POSH_THEME='paradox'

Create the directory and file if needed, then run reload. Oh My Posh also accepts a local configuration path or HTTPS URL in this variable. For the bundled iTerm2 configuration, use export LINUX_SETUP_POSH_THEME="$LINUX_SETUP_DIR/config/oh-my-posh/iterm2.omp.json". Remove the setting to restore the bundled quick-term default. Upstream theme names and URLs require network access and are cached by Oh My Posh; local files work offline. The installed Oh My Posh version determines which upstream themes are available.

Use a Nerd Font in your terminal emulator. Font, terminal colors, Git state, screen width, and available hardware affect the appearance. Battery and Python environment segments in the alternative theme appear when their context is available. See the preview gallery for both themes and the command picker, and font setup for details.

Repository layout

linux-setup/
├── install.sh                 # Bootstrap entry point
├── uninstall.sh               # Configuration, program, and cache removal
├── tools.lock.json            # Pinned release assets and plugin commits
├── bin/                       # Your portable executable scripts
├── config/
│   ├── zsh/                   # Shell settings, aliases, functions
│   ├── oh-my-posh/             # quick-term and iterm2 prompt themes
│   ├── tmux/                  # Pane, session, key, and status settings
│   ├── git/                   # Included delta settings
│   ├── bat/                   # File viewer settings
│   ├── ripgrep/               # Search settings
│   ├── yazi/                  # File manager settings
│   ├── lazygit/               # Git interface settings
│   └── codex/                 # Reference Oh My Posh MCP entry
├── scripts/                   # Installer, uninstaller, helpers, lock updater
├── docs/                      # Installation, recovery, troubleshooting, development
└── tests/                     # Installer, uninstall, helper, and isolated DB tests

Add shared aliases to config/zsh/aliases.zsh, functions to config/zsh/functions.zsh, and executable scripts to bin/. Rerun the installer to link new scripts. Edit the bundled default in config/oh-my-posh/quick-term.omp.json. Use reload after changing shell initialization or prompt settings.

Private or device-specific additions go in:

~/.config/linux-setup-local/zshenv  # Environment needed by all Zsh processes
~/.config/linux-setup-local/zshrc   # Interactive additions, editor choice, local aliases

For example, put export EDITOR='nvim' in the local zshrc if Neovim is installed. The initial migration preserves the existing Vite+ environment hook in the local zshenv. Other old files are backed up for reference. Your Git identity, credentials, SSH keys, shell history, project files, downloaded binaries, and private Codex settings are not copied into the repository.

XDG config/data/cache/state directories are respected. Executables always go in ~/.local/bin. Rootless base-package binaries and their runtime paths are generated separately on each device.

LINUX_SETUP_DIR points to the active checkout through its configuration link. DEV_SETUP_DIR remains a compatibility alias for existing personal scripts.