How to install geometry
brew install geometry geometry use case
Customize and enhance the zsh prompt with composable functions for displaying git status, command timing, and other shell information.
When to use geometry
- Setting up a new zsh development environment and wanting a polished, informative prompt
- Needing to display git status (branch, changes, stash, conflicts) directly in the prompt
- Building a custom shell prompt with modular, composable components that can be toggled on/off
When not to use geometry
- When using bash or other non-zsh shells (geometry is zsh-only)
- When a minimal, static prompt is sufficient and you want to avoid any additional overhead or dependencies
geometry features
- · Custom colored prompt symbol that changes color based on exit status or hostname
- · Git branch, state, time since last commit, and push/pull/rebase indicators
- · Asynchronous right prompt for performance
- · Secondary prompt for displaying configurable info (GEOMETRY_INFO)
Want your agent to find this automatically?
Add the MCP server to your agent config and it will discover tools like geometry on its own.
Set up MCP →