Miami Cruise / Apps / Zsh
Zsh
A configurable prompt with adaptive paths, async Git and compact context.


Install
Download
Download
miami-cruise-dark.zsh-themeandmiami-cruise-light.zsh-theme. Then open a terminal in the folder where they were saved (usuallyDownloads).Both colour variants support direct sourcing or Oh My Zsh. Installing the theme does not change your plugins, aliases or other shell settings. Use a Nerd Font for the complete icon set, or set
MIAMI_CRUISE_ASCII=1before loading the theme for plain ASCII symbols without a special font.curl -fsSLO https://lanjelin.github.io/miami-cruise/downloads/zsh/miami-cruise-dark.zsh-theme curl -fsSLO https://lanjelin.github.io/miami-cruise/downloads/zsh/miami-cruise-light.zsh-themeInstall alongside your existing Oh My Zsh setup
Install Oh My Zsh first. Copy both files into its custom themes folder. Keep your existing
plugins=(...), aliases and other settings. Back up any same-named custom themes before copying.Linux / macOSmkdir -p "${ZSH_CUSTOM:-${ZSH:-$HOME/.oh-my-zsh}/custom}/themes" cp miami-cruise-dark.zsh-theme miami-cruise-light.zsh-theme "${ZSH_CUSTOM:-${ZSH:-$HOME/.oh-my-zsh}/custom}/themes/"Set
ZSH_THEMEtomiami-cruise-darkormiami-cruise-lightin your current~/.zshrc, before the line that sourcesoh-my-zsh.sh. Replace the existing theme assignment; do not add a second one. Start a new shell to see it.ZSH_THEME="miami-cruise-dark"Leave your existing plugin list and
source "$ZSH/oh-my-zsh.sh"line intact. The downloaded theme does not alter completion, suggestions or syntax highlighting.Choose layout and scrollback
Layout and transient mode are independent and opt-in. Set them before sourcing Oh My Zsh, alongside
ZSH_THEME, then start a new shell. Omit a flag or set it to0to keep the original behaviour.MIAMI_CRUISE_SINGLE_LINE=1 MIAMI_CRUISE_TRANSIENT_PROMPT=1 # 0 = off, 1 = always, same-dir = repeated directories ZSH_THEME="miami-cruise-dark"MIAMI_CRUISE_SINGLE_LINE=1puts the context and command on one line instead of two.MIAMI_CRUISE_TRANSIENT_PROMPT=1reduces a submitted nonempty prompt to its coloured arrow, leaving the command and output in scrollback without user, host, path or Git context.Use
MIAMI_CRUISE_TRANSIENT_PROMPT=same-dirto keep the first submitted prompt after entering a directory complete, then compact subsequent prompts in that same directory. Returning to a directory after running a command elsewhere retains a full prompt again. Blank input and cancelled editing do not advance this directory tracking. The next editable prompt always shows full context again.When timestamps are enabled, compact prompts retain only the arrow on the left and submission time on the far right. This changes display only, not command history. It works with either layout and needs no Powerlevel10k plugin.
Terminal scrollback preservation can retain an old prompt when a redraw clears the screen; in tmux, its
scroll-on-clearoption controls this (the theme does not change it).Choose context segments
The block below shows the defaults, grouped by purpose. Boolean flags accept
1(on) or0(off): set an off-by-default flag to1to opt in, or an on-by-default flag to0to opt out. Omitted settings use their defaults. Configure them before loading the theme, whether sourcing it directly or through Oh My Zsh; these options work with either layout and every transient mode. Right-hand segments appear left to right in this order: Python/Conda environment, shell/Yazi level, ASCII vi-mode label, jobs, command duration, failure details, timestamp. Disabled or empty segments are omitted; the timestamp is always rightmost. Identity, directory, Ruby and Git context appear on the left. In Unicode mode, vi mode changes the prompt arrow instead of adding a right-hand label. Vi-mode display does not change your key bindings.# Identity and directory MIAMI_CRUISE_SMART_CONTEXT=0 # off by default: user@host only for SSH/root MIAMI_CRUISE_SHOW_READ_ONLY=1 # on by default: lock before non-writable path MIAMI_CRUISE_SHOW_SHELL_LEVEL=0 # off by default: nested shell/Yazi level MIAMI_CRUISE_SHOW_VIRTUALENV=1 # on by default: Python virtualenv/Conda name # Git MIAMI_CRUISE_SHOW_GIT=1 # on by default: Git status segment MIAMI_CRUISE_ASYNC_GIT=1 # on by default: background status; 0 = synchronous MIAMI_CRUISE_SHOW_GIT_OPERATION=0 # off by default: merge/rebase/cherry-pick/bisect/am # Command results MIAMI_CRUISE_SHOW_RETURN_CODE=1 # on by default: nonzero exit status MIAMI_CRUISE_SHOW_PIPELINE_STATUS=0 # off by default: per-stage codes for failed pipelines MIAMI_CRUISE_SIGNAL_NAMES=0 # off by default: signal names instead of numbers # Timing and jobs MIAMI_CRUISE_SHOW_DURATION=1 # on by default: long-command duration MIAMI_CRUISE_DURATION_THRESHOLD=3 # default: 3 seconds; nonnegative decimals allowed MIAMI_CRUISE_SHOW_JOBS=1 # on by default: running/suspended job counts MIAMI_CRUISE_SHOW_TIMESTAMP=0 # off by default: local HH:MM:SS, always far right # Input mode and symbols MIAMI_CRUISE_SHOW_VI_MODE=0 # off by default: vi-mode indicator; bindings unchanged MIAMI_CRUISE_ASCII=0 # off by default: plain ASCII theme symbolsMIAMI_CRUISE_SHOW_RETURN_CODE=1(the default) shows the return-code indicator for failed commands (for example1 ↵). Set it to0to hide it. Successful commands remain unmarked. This affects display only, not command exit status.MIAMI_CRUISE_SHOW_TIMESTAMP=1adds a muted localHH:MM:SStimestamp as the absolute rightmost segment, after status and every other indicator. It shows prompt creation time while editing, refreshes to submission time when you submit, and remains visible in transient scrollback. It is not a continuously ticking clock. Like other right-prompt segments, it can be hidden by Zsh when command input overlaps it.Elapsed time uses a Nerd Font stopwatch (for example
3.4s, or3.4sin ASCII mode) and appears after a foreground command meets the threshold and resets for the next command; editing time is excluded. Invalid thresholds fall back to 3 seconds.⚙2means two running jobs;Ⅱ1means one suspended job. Job counts refresh on the next prompt.With
MIAMI_CRUISE_SHOW_VI_MODE=1, the prompt arrow indicates insert (➤), normal (❮), visual (V) or replace (▶) mode, without an extra right-side label. In ASCII mode, the arrow stays>and right-side labels[INS],[NOR],[VIS]and[REP]indicate the mode instead. Emacs editing is treated as insert. Disabling the flag restores the ordinary arrow and removes labels. Colours, key bindings and existing widgets are unchanged. Existing widgets/hooks are preserved using Zsh dispatchers, without duplicate registrations when re-sourcing.Python environments appear leftmost on the right-hand side, with a Nerd Font Python icon before the parenthesized name (for example
(myenv)); ASCII mode keeps(myenv). A Python venv is shown only when its existingbindirectory is onPATH, so stale inherited metadata alone does not create a badge. For an active Python venv, the name comes fromVIRTUAL_ENV_PROMPTwhen nonempty, otherwise the final directory name fromVIRTUAL_ENV. Without an active venv, it falls back toCONDA_DEFAULT_ENV. No Oh My Zsh helpers are required. Child shells can inherit a usable environment without the shell-localdeactivatefunction; the theme displays that environment but does not activate or deactivate it.If your activation script also prepends an environment name, configure that tool to disable its own prompt modification (for standard venv, set
VIRTUAL_ENV_DISABLE_PROMPT=1before activation).Ruby remains optional and uses
ruby_prompt_infoonly when available. The generated files also work when sourced directly in Zsh 5.9, without Oh My Zsh.MIAMI_CRUISE_SHOW_PIPELINE_STATUS=1shows a failed pipeline as[1|0] ↵, including an earlier failure when the final command succeeds; all-success pipelines stay unmarked.MIAMI_CRUISE_SIGNAL_NAMES=1translates conventional signal statuses into names such asSIGINTorSIGTERM. An explicitexit 130cannot be distinguished from SIGINT.MIAMI_CRUISE_SHOW_RETURN_CODE=0hides both kinds of failure detail. These are display options: the theme never changespipefailor command exit status.MIAMI_CRUISE_SHOW_GIT_OPERATION=1adds interrupted operations to the Git segment:merge,rebase 2/5(when progress is available),cherry-pick,revert,bisectoram. Checks run in the existing async worker and support linked worktrees; disabling async makes these checks synchronous too. No Git metadata is changed.MIAMI_CRUISE_SMART_CONTEXT=1hides user@host locally but keeps it for SSH sessions and root.MIAMI_CRUISE_SHOW_READ_ONLY=1(the default) adds a lock iconimmediately before the path when the current directory fails an effective-user writability check (a Nerd Font is needed for the lock glyph; ASCII mode uses[RO]in the same position); setMIAMI_CRUISE_SHOW_READ_ONLY=0to hide it. This is not a prediction that every file operation will succeed.MIAMI_CRUISE_SHOW_SHELL_LEVEL=1adds sh:2forSHLVLabove 1, or yazi:1when a positiveYAZI_LEVELis present. These icons require a Nerd Font; ASCII mode keepssh:2andyazi:1without icons. Shell depth follows inherited environment values and can include terminal launch wrappers.MIAMI_CRUISE_ASCII=1selects>,+-,git:,^/v,x,exit,jobs:andstopped:instead of font-dependent theme glyphs. It applies to both layouts and transient prompts, without rewriting branch names, paths or other user text. Set this flag before sourcing; re-source or restart to switch symbol sets. Pipeline details, signal names, Git operation labels, smart context, shell depth and ASCII mode default to0; the read-only marker defaults to1. No new external dependencies are needed: Zsh handles shell context and the existing Git executable handles repository information.Read the path and Git segments
Paths stay complete until they exceed 80 characters or the available space in a narrow terminal. Then intermediate folders use their shortest unique sibling prefixes. The final folder and project roots (for example a folder containing
.git,package.jsonorgo.mod) stay complete. The abbreviated path is display-only;$PWDis unchanged.For example,
master ⇡2 ?1means the branch is master, two commits ahead of its upstream and one untracked file.⇣is commits behind,+staged files,!unstaged files and×conflicts. Zero counts are hidden; there is no Git segment outside a repository.Ahead/behind compares against your local upstream-tracking ref. Run
git fetchto refresh it; the prompt does not contact the network. Git status refreshes in a background worker and redraws without changing typed text. The first prompt may briefly have no Git segment; later refreshes retain the last result only in the same directory. Changing directories clears it immediately and ignores old results. Workers use no temporary files and perform no fetches. SetMIAMI_CRUISE_ASYNC_GIT=0for the blocking fallback, orMIAMI_CRUISE_SHOW_GIT=0to disable Git entirely. Detached heads show a short commit ID. Operation labels are available withMIAMI_CRUISE_SHOW_GIT_OPERATION=1; stash counts and tag labels are not included yet.Switch or remove
To switch, change only
ZSH_THEMEto the other variant and start a new shell. There is no automatic dark/light switching. To remove, restore your previousZSH_THEMEvalue and start a new shell; then delete the copied files if desired.This colours the prompt only. Command syntax highlighting is controlled by its plugin, and terminal text/background by your terminal theme. Original theme and customization reference: https://github.com/ohmyzsh/ohmyzsh/wiki/Customization#overriding-and-adding-themes
Install with an agent
Paste this prompt into an agent with web access and access to the machine where your apps run. No cloning, building or manual file downloads needed.
Help me install Miami Cruise. Read
https://raw.githubusercontent.com/lanjelin/miami-cruise/main/INSTALL.md
and follow its linked playbooks. Inspect and propose installation for Zsh only; ask which variant I want.
Download the selected files yourself from the project website or a pinned GitHub revision. Propose exact changes and wait for my approval before making changes. Include private backups and conflict-aware restoration instructions and scripts before applying changes.The agent inspects first and asks for approval. If it cannot access your machine, it can provide tailored commands instead. Read the installation and restoration guide.