repos / zmx

session persistence for terminal processes
git clone https://github.com/neurosnap/zmx.git

commit
1e4e888
parent
954b392
author
ida
date
2026-02-26 20:26:01 -0500 EST
Add starship shell prompt instructions (#62)

1 files changed,  +18, -0
M README.md
+18, -0
 1@@ -153,6 +153,24 @@ POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS+=my_zmx_session
 2    style = 'plain'
 3 ```
 4 
 5+### starship
 6+
 7+[starship](https://starship.rs) is a popular shell themeing and prompt engine. This code will display the session name as part of the prompt if (and only if) you have zmx active:
 8+
 9+```
10+format = """
11+${custom.zmx}\
12+...
13+"""
14+
15+...
16+
17+[custom.zmx]
18+command = 'echo "[${ZMX_SESSION}]"'
19+when = 'test "${ZMX_SESSION}" != ""'
20+style = "bold magenta"
21+```
22+
23 ## shell completion
24 
25 Shell auto-completion for `zmx` commands and session names can be enabled using the `completions` subcommand. Once configured, you'll get auto-complete for both local `zmx` commands and sessions: