Skip to content
nobspromptby neg4n.dev
Esc
↑↓navigate↵open⌘Jpreview
On this page

nobsprompt

Run a native macOS and Zsh prompt out of the box, or use its detached backend to build your own without foreground Git or Node processes.

Choose the fixed opinionated prompt, or keep the same asynchronous backend and own every presentation decision in Zsh. Either path keeps Git and Node off the foreground rendering path.

/U/i/D/p/nobsprompt [main +1 ~2 ?3 ^1] [node:22.14.0] [2.4s] [jobs:2] %
The built-in prompt stays readable while repository and command state changes.

The native nbsp binary has no third-party library links, no daemon, and no font requirement. Detailed Git status is published to a versioned cache with atomic pathname replacement.

Start with the installation guide, which recommends bounded autosuggestions and explains when to disable them for plugin compatibility.

Opinionated prompt

Install one deliberately fixed prompt with path, Git, Node, timing, jobs, and exact failure status.

Detached mode

Keep the native backend and asynchronous lifecycle while owning every presentation decision.

Autosuggestions

Add recent-history ghost text and bounded, point-in-time directory suggestions without replacing Tab completion.

Features

  • an abbreviated working directory;
  • Git branch and staged, modified, untracked, conflicted, ahead, behind, and stash counts;
  • a version derived from NVM_BIN without starting Node;
  • command duration, background jobs, and exact exit status;
  • asynchronous Git refresh with ZLE redraw correction;
  • a private external-command editor widget, bound to Alt+E where that key is undefined, with multiline buffers and cursor restoration for vi, vim, and nvim;
  • opt-in recent-history ghost text plus cd suggestions built from bounded, asynchronous directory snapshots rather than per-key filesystem scans;
  • a versioned line or NUL-delimited data interface for custom consumers.

What it deliberately avoids

There is no daemon, database, format language, plugin system, or font requirement. The prompt and data paths start no Git or Node process; the Zsh integration schedules the separate refresh worker asynchronously. The opinionated prompt is intentionally fixed. Detached mode exists for users who want different colors, symbols, layout, segments, thresholds, or OSC wrappers.

How it works

Follow the foreground read, background refresh, cache publication, and redraw lifecycle.

CLI reference

See every command, option, data format, refresh control, and process exit status.