Module reference
Search every Starship module and the builder's prompt components by name, purpose, or category. Module pages explain when they appear and list their options; component pages explain the format syntax they generate.
107 references
Prompt components
Text component
Add literal text, spacing, separators, labels, Unicode characters, and Nerd Font symbols anywhere in the prompt.
Core
Character module
Render the final input character for success, error, and Vim editing modes.
Command duration module
Shows how long the last command took to execute
Custom module
Run a named command and display its output with Starship's detection, format, and style system.
Directory module
Show the current working directory with controlled truncation, repository-root treatment, read-only indicators, and style.
Environment variable module
Shows the value of an environment variable you choose
Fill module
Configure Starship's Fill module.
Jobs module
Shows the current number of jobs running
Line break module
Separates the prompt into two lines
Package module
Is shown when the current directory is the repository for a package, and shows its current version
Shell module
Shows an indicator for currently used shell
Status module
Shows the exit code of the previous command
Time module
Shows the current **local** time
Git
Fossil branch module
Shows the name of the active branch of the check-out in your current directory
Fossil metrics module
Will show the number of added and deleted lines in the check-out in your current directory
Git branch module
Show the active Git branch, its remote relationship, and a branch symbol when the current directory is inside a repository.
Git commit module
Shows the current commit hash and also the tag (if any) of the repo in your current directory
Git metrics module
Will show the number of added and deleted lines in the current git repository
Git state module
Shows what operation is in progress — rebase, merge, cherry-pick, bisect, revert or git am
Git status module
Summarise staged, modified, deleted, renamed, conflicted, untracked, stashed, ahead, and behind Git state.
Mercurial branch module
Shows the active branch and topic of the repo in your current directory
Mercurial state module
Shows the Mercurial operation in progress, such as merging or rebasing
Pijul channel module
Shows the active channel of the repo in your current directory
Version control module
Uses the first detected version-control system and renders its configured modules
VCSH module
Displays the current active VCSH repository
Languages
Bun module
Shows the currently installed version of the bun JavaScript runtime
C module
Shows some information about your C compiler
COBOL module
Shows the currently installed version of COBOL
C++ module
Shows some information about your C++ compiler
Crystal module
Shows the currently installed version of Crystal
Daml module
Shows the currently used Daml SDK version when you are in the root directory of your Daml project
Dart module
Shows the currently installed version of Dart
Deno module
Shows you your currently installed version of Deno
.NET module
Shows the relevant version of the .NET Core SDK for the current directory
Elixir module
Shows the currently installed version of Elixir and Erlang/OTP
Elm module
Shows the currently installed version of Elm
Erlang module
Shows the currently installed version of Erlang/OTP
Fennel module
Shows the currently installed version of Fennel
Fortran module
Shows the current compiler version of Fortran
Gleam module
Shows the currently installed version of Gleam
Go module
Shows the currently installed version of Go
Haskell module
Finds the current selected GHC version and/or the selected Stack snapshot
Haxe module
Shows the currently installed version of Haxe
Java module
Shows the currently installed version of Java
Julia module
Shows the currently installed version of Julia
Kotlin module
Shows the currently installed version of Kotlin
Lua module
Shows the currently installed version of Lua
Mojo module
Shows the current version of Mojo programming language installed
Nim module
Shows the currently installed version of Nim
Node.js module
Show the active Node.js version when the current project or files indicate a JavaScript runtime.
Ocaml module
Shows the currently installed version of OCaml
Odin module
Shows the currently installed version of Odin
Perl module
Shows the currently installed version of Perl
Php module
Shows the currently installed version of PHP
PureScript module
Shows the currently installed version of PureScript version
Python module
Show the Python version and active virtual environment for detected Python projects.
Quarto module
Shows the current installed version of Quarto used in a project
Raku module
Shows the currently installed version of Raku
Red module
By default the red module shows the currently installed version of Red
R module
Shows the currently installed version of R
Ruby module
By default the ruby module shows the currently installed version of Ruby
Rust module
By default the rust module shows the currently installed version of Rust
Scala module
Shows the currently installed version of Scala
Solidity module
Shows the currently installed version of Solidity The module will be shown
Swift module
By default the swift module shows the currently installed version of Swift
Typst module
Shows the current installed version of Typst used in a project
V module
Shows you your currently installed version of V
Zig module
By default the zig module shows the currently installed version of Zig
Build Tools
Buf module
Shows the currently installed version of Buf
Cmake module
Shows the currently installed version of CMake
Gradle module
Shows the version of the Gradle Wrapper currently used in the project directory
Maven module
Indicates the presence of a Maven project in the current directory
Meson module
Shows the current Meson developer environment status
Spack module
Shows the current Spack environment, if $SPACK_ENV is set
Vagrant module
Shows the currently installed version of Vagrant
Xmake module
Shows the currently installed version of XMake
Cloud & Tools
AWS module
Show the active AWS profile, region, and temporary-credential duration.
Azure module
Shows the current Azure Subscription
Claude context module
Configure Starship's Claude context module.
Claude cost module
Configure Starship's Claude cost module.
Claude model module
Configure Starship's Claude model module.
Conda module
Shows the current Conda environment, if $CONDA_DEFAULT_ENV is set
Direnv module
Shows whether the current directory's .envrc is loaded and allowed
Docker context module
Shows the active Docker context when it is not the default
Google Cloud module
Shows the current configuration for gcloud CLI
Guix shell module
Shows the guix-shell environment
Helm module
Shows the currently installed version of Helm
Kubernetes module
Show the active Kubernetes context, namespace, user, and cluster with context-specific aliases.
Mise module
Shows the current mise health as reported by running mise doctor
Nats module
Shows the selected NATS context
Nix shell module
Shows the nix-shell environment
Opa module
Shows the currently installed version of the OPA tool
OpenStack module
Shows the current OpenStack cloud and project
Pixi module
Shows the Pixi version and the active environment
Pulumi module
Shows the current username, selected Pulumi Stack, and version
Singularity module
Shows the current Singularity image, if inside a container and $SINGULARITY_NAME is set
Terraform module
Shows the currently selected Terraform workspace and version
System
Battery module
Shows how charged the device's battery is and its current charging status
Container module
Displays a symbol and container name, if inside a container
Hostname module
Show the machine hostname, optionally only for SSH sessions, with aliases and domain trimming.
Local IP module
Shows the IPv4 address of the primary network interface
Memory usage module
Shows current system memory and swap usage
Network namespace module
Shows the active Linux network namespace
Operating system module
Shows the current operating system
Shell level module
Shows how many shells deep you are nested
Sudo module
Shows whether cached sudo credentials are currently active
Username module
Show the current user and apply separate styles for regular and root sessions.