starship Release Notes

1.27.0 (2026-10-17)

Security

This release contains fixes for GHSA-x486-6jjc-phfp and GHSA-679r-jwc5-r5m3.

Features

• Add jj_bookmark module (#7643) (6f33dce)
• add jj_change module (#7691) (70c705e)
• add jj_metrics module (#7720) (471858d)
• add jj_status module (#7729) (3ead2a0)
• Add Jujutsu support to the vcs module (#7612) (131bf95)
• bash: Support right prompt in Bash via Flyline (#7673) (85b8a61)
• claude_model: add effort variable (#7614) (ea4098c)
• git_branch: add ignore_remotes option (#7671) (0f9da35)
• jj: Better bookmark discovery and improving JJ output parsing (#7761) (013bef4)
• package: detect zig package version from build.zig.zon (#7753) (0584026)
• terraform: detect OpenTofu's .tofu files (#7783) (d77931d)

Bug Fixes

• bash: avoid duplicating PS0 preexec hook (#7587) (8f28dfc)
• directory: render symlinks pointing into a repo subdirectory (#7715) (2bc6acf)
• git: avoid running sensitive git commands in untrusted environments (fixes GHSA-679r-jwc5-r5m3) (db847dd)
• hostname: check SSH_CLIENT and SSH_TTY in addition to SSH_CONNECTION (#7611) (d1f5271)
• jj_status: count file changes across the whole repository (#7780) (2d8741e)
• nim: use detect_folders for folder detection (#7757) (ba04cfb)
• openstack: resolve clouds.yaml from context current directory (#7655) (6d88346)
• package: support build.gradle.kts in gradle version detection (#7627) (0461483)
• preset: Pad OS icon instead of username so it is not clipped when hidden (#7598) (91086e8)
• pulumi: read the per-backend stack selection (#7724) (69c1a57)
• sudo: Avoid creating system error logs on every unsuccessful invocation (#7530) (564a471)
• sudo: sudo module pollutes journalctl with error logs (564a471)
• utils: Avoid unbounded file reads (fixes GHSA-x486-6jjc-phfp) (187e183)
• utils: fix humanize_int rounding across unit boundaries (#7770) (084cdf2)

Performance Improvements

• swift: prefer swift-frontend for version detection (#7775) (bbde871)

1.26.0 (2026-06-28)

Features

• git_state: show git am progress (#7500) (26ce2cc)
• git: enable sha256 support (#7531) (e1418b2)
• nix-shell: Add level variable to show nix shell depth (#7394) (b85b7b9)
• pixi: expose PIXI_PROJECT_NAME as format placeholder (#7346) (cfd5e76)
• time: improve timezone handling by switching to jiff (#7222) (3dd8c14)

Bug Fixes

• gcloud: honor CLOUDSDK_COMPUTE_REGION env variable (#7451) (d0e2468)
• improve reliability of config-file writing (#5426) (57bb99b)
• maven: avoid detecting user .mvn config as project (#7426) (d455255)
• nodejs: avoid deno project files (#7478) (96c1f90)
• preset: make OS symbol dynamic in Tokyo Night theme (#7555) (9627650)
• statusline: handle null context_window fields at session start (#7533) (0185e48)
• use cargo-zigbuild for riscv64gc-unknown-linux-musl release builds (#7449) (166d7bb)

1.25.0 (2026-04-18)

Features

• add Maven module (#7189) (70b0f73)
• add statusline subcommand for Claude Code integration (#7234) (b8ee821)
• battery: Update default unknown_symbol (#7278) (88d384f)
• directory: add support for regexes in substitutions (#7145) (2e8f26e)
• env_var: include $symbol in default format (#7262) (3885e81)
• git_status: add variables to track worktree and index changes (#5655) (0110bf5)
• python: add option to replace generic venv-names with parent dir (#7112) (083ab00)
• vcs: Introduce the VCS module (#6388) (0dd5a4f)

Bug Fixes

• aws: isolate tests from host AWS config files (#7196) (e910f47)
• aws: support $duration for sso_session (#7100) (8108cc9)
• direnv: accept null loadedRC state (#7317) (56b8901)
• docs: Re-add style option to env_var module (#7298) (e2277e5)
• enable std feature for whoami crate (#7211) (9931ab2)
• format: allow empty textgroups to set prev_fg/prev_bg (#7201) (9186188)
• helm: remove deprecated --client flag from helm version command (#7193) (8a69666)
• hg_state: avoid false-positive MERGING state (#7329) (7a27475)
• install: improve UX for version option (#7197) (c576625)

1.24.2 (2025-12-30)

Bug Fixes

• cmd_duration: avoid freezing on notify on macOS 26 (#7187) (0daa8d3)
• fish: restore job counting compability with older versions (#7173) (a261b48)
• fish: use native transient prompt if available (#7015) (cc65e0c)
• git: Basic Reftable compatibility and future-proofing (#7154) (6d9c8ea)
• mise: align documentation and implementation (#7131) (08824d7)
• Revert "feat(install.sh): handle installation directory prompt case-insensitively (#7138) (d11bc8d)
• zsh: fix job counting (#7124) (46ab862)

1.24.0 (2025-10-25)

Features

• add mercurial state (#6745) (5f0b31b)
• aws: support duration for aws sso (#6614) (44e9e56)
• cli: accept 'powershell' for completions subcommand (#7028) (4caee4a)
• container: Add detection of Incus containers (#6917) (6886ad0)
• fish: support input-mode detection for helix-keybinds (#6841) (26a6237)
• Fortran module (#6685) (90d8c4a)
• git_branch: add ignore_bare_repo flag (#6936) (87b7ac3)
• install.sh: handle installation directory prompt responses case-insensitively (#6866) (bc48b5f)
• new module xmake (#6811) (ff0acb1)
• nu: Add job support for nushell (#6684) (ac2359c)
• package: Add support for Ansible Galaxy (#6905) (07778a8)
• package: pyproject hatchling dynamic version (#6656) (ef5227e)
• terraform: support opentofu for terraform version detection (#6910) (ef7d8bd)

Bug Fixes

• consider text-only meta variables in conditionals set if non-empty (#6338) (286b0f2)
• docker_context: add compose.yml and compose.yaml to files (#6625) (a98a05f)
• explain: Filter out non-printing ANSI escape codes (#6861) (2c11c08)
• fossil_metrics: match single-file (#6785) (5dd40ea)
• git_metrics: adhere to git_status use_git_executable option (#6927) (05daa3e)
• git_status: Do not show up-to-date when untracked (#6755) (f42b53e)
• hg_branch: Strip extraneous newlines from hg topic. (#6766) (ccc32e7)
• improve adhere to directory scanning timeout (#6694) (109a681)
• jobs: Count job groups instead of processes for fish (#6899) (95bf53f)
• modules: username detect_env_vars logic (#6934) (a60df1d), closes #6870
• nushell: Startup cmd_duration should be 0ms not 823ms (#6854) (0ad1cf8)
• pixi: Don't trigger pixi module by .pixi directory (#6709) (a477186)
• preset/nerd-font: remove double spaces in gcloud default value and use Google Cloud-specific icon (#6822) (3b5bbe3)
• preset/pure: only enable python module if venv is active (#6689) (5e8851a)
• presets/plaint-text: Add missing entries (#6929) (e593332)
• remove double spaces in default values (#6649) (e406f55)
• rust-ini 0.21.2 has been yanked from crates.io. (#6916) (b698fb0)
• terraform: amend module to exec_cmds_return_first-changes (#6956) (0f5d8d4)
• test/git_commit: avoid spawning an editor lead to timeout if tag signing is enabled (#6887) (32c29cf)
• time: don't print misleading log message (#7008) (5db4ea7)
• zsh: check if vars are set before reading them (#6742) (608ae37)
• zsh: do not fail under ERR_EXIT conditions if STARSHIP_DURATION computes to 0 (#6922) (38db5f0)

Performance Improvements

• git_status: avoid gix index load when core.fsmonitor is used (#6817) (1c2f4d4)
• Parallelize child modules for env_var|custom (#6748) (7f4eb6f)

1.23.0 (2025-04-27)

Features

• add network namespace module (#6449) (eb42f5a)
• Add support for pixi (#6335) (7e88ba9)
• added mise module (#5747) (d24e787)
• c++: adding c++ module (#6570) (ed07646)
• completions: Offer Nushell completions (#6366) (df454d5)
• nodejs: disable if bun project files detected (#6346) (00ce705)
• package: support JSR package version (#6502) (bd2321a)
• preset: Add gcloud symbol to nerd-fonts preset to match aws (#6693) (348c23f)
• python: add support for python_binary arguments in config (#6523) (7667555)

Bug Fixes

• battery: prefer charge ratio over current capacity (#6603) (d245939)
• Change to a non-yanked version of the log crate (#6495) (ed20b1d)
• fossil_metrics: Add -i flag to the fossil_metrics module's command (#6544) (eb7d80b)
• package: fix cargo workspace version (#6626) (834bbf5)
• preset: add missing rlang to plain-text-symbols preset (ddafaa6)
• preset: add missing rlang to plain-text-symbols preset (#6458) (ddafaa6)

Performance Improvements

• ancestor-scan: preallocate and reuse a single PathBuf (#6387) (b3cb92e)
• use gitoxide for git_status and git_metrics modules (#6476) (daf8d93)

Reverts

• Remove specialized whoami hostname function choice for windows (#6651) (8eefdb2)

1.22.0 (2025-01-11)

Features

• battery: Use best match instead of first match for battery.display threshold (#6442) (2690a32)
• bun: Detect bun using new text-format lockfile (#6441) (2df521c)
• direnv: allow direnv to detect environment variables (#6196) (4593716)
• status: add {success,failure}_style options (#6269) (e21775c)

Bug Fixes

• fish: restore support for fish <v3.4.0 (#6337) (85d3fb2)
• handle variable bash $SHLVL behavior with explicit option (#4912) (7ead2b5)
• hostname: use DNS instead of NetBIOS name on Windows (#6343) (43f097e)
• init/pwsh: preserve ViModeChangeHandler (#6225) (9b6d394)
• init: do not use cygpath for elvish (#6376) (576aa14)
• status: add trailing space to pipestatus_format (#6404) (8a38b8f)
• username: avoid using whoami on android (#6342) (af5d139), closes #6340

1.21.0 (2024-10-17)

Yanked due to #6325.

Features

• deno: add deno.lock file to default detect_files list (#6310) (22c6c52)
• hostname: add option to replace hostnames with aliases (#6097) (68a8fc9)
• mojo: add module for Mojo language (#6108) (171746a)
• package: support alternative gradle module version syntax (#6079) (a62012e)
• python: Add detect env vars option (#4486) (8a2d944)
• python: detect pixi and ipynb files (#6228) (36134d8)
• release: codesign windows release binaries (#6273) (fcc697b)

Bug Fixes

• bash: fix variable leak in Bash integration (#6143) (e1189ed)
• cmd_duration: Make render_time format more consistent (#5825) (4abea6b)
• docker_context: Ignore Docker Desktop "desktop-linux" context. (#6314) (14babde)
• docs: correct username options (#6084) (d96fbc5)
• fish: add missing arguments for fish transient prompt functions (#6181) (d6814be), closes #6180
• fish: improve fish transient prompt (#6107) (274dff3)
• fish: use correct input function in transient execute (#6265) (244c2c6)
• Fixed "Click to download TOML" links (#6234) (0200d75)
• git_status: read proper name for core.fsmonitor flag (#6173) (33b3b8e)
• package: support alternative gradle module version syntax (#6080) (a62012e)
• python: improve parsing of pyvenv.cfg files (#6145) (7b65ad5)
• use whoami for user/hostname queries again (#6311) (77f0883)

Performance Improvements

• fish: Skip unnecessary indirection in starship init fish (#6253) (798f640)
• Skip unnecessary indirection in starship init fish (798f640)

1.20.0 (2024-07-26)

Features

• color: add prev_fg and prev_bg as color specifiers based on the previous foreground/background colors respectively (#6017) (9a3e87f)
• color: add prevfg,prevbg as color specifiers based on the previous foreground/background colors respectively (9a3e87f)
• gcloud: Disabled gcloud module when active config hasn't been set (#6039) (4d36d46)
• purescript: add support for spago-next configuration files (#6036) (e028186)

Bug Fixes

• custom: escape characters in command output by default (GHSA-vx24-x4mv-vwr5/CVE-2024-41815) (cfc5816)
• direnv: replace nonexistent "orange" color with "bright-yellow" (#5969) (478d5cc)
• dotnet: Remove duplicate v in dotnet version (#6060) (52a89a5)
• improve non-msvc windows support by bumping stable dependencies (#5989) (50a6b84)
• k8s: don't trigger if scan config is set but env vars are not (#5979) (8c75822)
• preset: fix typo in Open Policy Agent module format string (#6118) (eba9748)

Performance Improvements

• k8s: Improve performance of kubeconfig module (#6032) (fae92b2)