💎 Prompt — full reference➜

A 3-line cobalt + magenta starship prompt with right-aligned battery + clock. Every segment is contextual: it only shows when it has something useful to say.

Rich starship prompt

Failure state

Anatomy➜

# Line 1 (left format)                                  + right_format
╭─  ~/Code/dotfiles   on   main !8 ?15           🐳   [bat]  [time]
   │                  │    │                      │      │     │
   │                  │    │                      │      │     └─ time
   │                  │    │                      │      └─ battery
   │                  │    │                      └─ colima (🐳 if running)
   │                  │    └─ git_branch + status
   │                  └─ "on" literal
   └─ directory

# Line 2
│  ⎈ docker-desktop (default)   3.12.1 (venv)  took 4s
│   │                          │              │
│   │                          │              └─ cmd_duration
│   │                          └─ python
│   └─ kubernetes

# Line 3
╰─❯
   └─ character

Segment reference & toggles➜

✅ Active segments➜

Segment	Trigger	Visual	Disable
`directory`	always	cobalt path, truncated to 4 components	remove `$directory` from `format`
`git_branch`	inside any git repo	magenta `<branch>`	`[git_branch] disabled = true`
`git_status`	dirty repo	`!N` modified, `+N` staged, `?N` untracked, `⇡N`/`⇣N` ahead/behind	`[git_status] disabled = true`
`kubernetes`	dir contains `k8s/` or `Chart.yaml`	cyan `⎈ <ctx> (<ns>)`	`[kubernetes] disabled = true`
`azure`	logged into az cli	bold cobalt `󰠅 <subscription>`	`[azure] disabled = true`
`python`	python project markers	green `<ver> (<venv>)`	`[python] disabled = true`
`cmd_duration`	last cmd > 2s	amber `took 4s`	`[cmd_duration] min_time = 99999999`
`character`	always	cobalt `❯` / magenta `✗ ❯` / green `❮` (vim)	always required
`battery`	macOS / laptops	colour-coded percent	`[battery] disabled = true`
`time`	always	grey `HH:MM`	`[time] disabled = true`
`custom.colima`	colima VM running	green `🐳`	`[custom.colima] disabled = true`

🟡 Pre-configured but dormant (flip `disabled` and add to `format`)➜

nodejs · golang · terraform · username · hostname

🔴 Off-by-default➜

aws · gcloud · docker_context · package · jobs · memory_usage · os · shell · 50+ language modules

Full list: https://starship.rs/config/

Adding / removing segments➜

The format field in zsh/starship.toml controls what renders and where:

format = """
[╭─](grey) $directory$git_branch$git_status${custom.colima}
[│ ](grey)$kubernetes$azure$python$cmd_duration
[╰─](grey)$character"""

right_format = """$battery$time"""

Add a segment by inserting $<name> (or ${custom.<name>} for custom modules) in the desired position. Remove by deleting it. Changes take effect on next shell.

Recipes➜

Hide the time / battery

right_format = ""               # remove both
right_format = """$battery"""   # keep battery only

Make it a one-line prompt

format = """$directory$git_branch$git_status$kubernetes$azure$python$cmd_duration$character"""

Always show full directory (no truncation)

[directory]
truncation_length = 0
truncate_to_repo = false

Show k8s context everywhere (not just in k8s dirs)

[kubernetes]
detect_files = []
detect_folders = []

Add Go version when in a Go project

[│ ](grey)$kubernetes$azure$golang$python$cmd_duration

Add AWS profile / region

[aws]
disabled = false
format = "[ $symbol($profile)(@$region)]($style) "
symbol = " "
style  = "bold amber"

Then [│ ](grey)$kubernetes$azure$aws$python$cmd_duration in format.

Make slow commands warn loudly

[cmd_duration]
min_time = 500
format   = "[took $duration ⚠]($style) "
style    = "bold red"

Disable starship entirely (back to oh-my-zsh)

Comment out eval "$(starship init zsh)" in ~/.zshrc.