Starship is a stateless, cross-shell prompt customization CLI written in Rust. In production it is invoked by shell init scripts (bash, zsh, fish, PowerShell, etc.) via `starship prompt`, and it emits a fully styled ANSI prompt string. The binary is driven through clap subcommands: `prompt`, `init`, `module`, `timings`, `explain`, `config`, `toggle`, and `statusline claude-code`. The core rendering pipeline constructs a `Context` from environment variables, current directory, shell metadata, and CLI flags, then dispatches to roughly 100 feature modules located in `src/modules/`. Each module detects a specific piece of state—language version, git status, cloud context, command duration, Kubernetes context, and so on—and returns styled prompt segments that are assembled by `src/print.rs`. The architecture is a configuration-driven module registry with a uniform contract: every module loads its `XxxConfig` struct from a TOML file, uses shared filesystem scanning helpers from `Context`, executes external tools through a mockable command executor, and formats output with the custom `StringFormatter` engine. Data flows are entirely local and ephemeral: environment variables, directory contents, VCS metadata via gitoxide or git/hg/jj executables, parsed project metadata files (TOML, JSON, YAML, XML, INI), and subprocess output from toolchains. There is no server, database, or persistent state. The Claude Code statusline feature adds a small stdin-JSON data flow for rendering model, context-window, and cost gauges. Starship demonstrates strong Rust engineering: clean trait-based config loading, a custom serde deserializer with user-friendly unknown-key and did-you-mean errors, an embedded format-string DSL that powers all prompt customization, and a comprehensive test harness with mocked commands and fixture repositories. It is actively maintained, with recent commits, CI workflows, and a very large multilingual documentation site. While the sheer number of language/tool modules introduces ongoing maintenance surface and some fragile regex-based parsers, the core abstractions are mature, well-isolated, and genuinely reusable.
This repository provides a configuration setup for a modern terminal environment on macOS, comprising the Ghostty terminal emulator, Starship prompt, and Zsh shell with plugins (autosuggestions, syntax highlighting, completions) and additional CLI tools (fzf, zoxide, eza, bat, yazi). The included install.sh script automates the installation of dependencies via Homebrew, backs up existing configurations, and deploys the new configuration files. The configuration files are well-documented and customized for a cohesive, visually appealing terminal experience with features like a rainbow prompt, glassmorphism, and enhanced productivity tools. Note: This repository is primarily a collection of configuration files and an installation script, and does not contain application logic beyond the setup process.