Practical overview
When it fits
Use um when you want command suggestions or command-history search without leaving the terminal, or when you want its documented Terraform template workflow.
Who it is for
- Terminal users who want to look up shell commands using natural-language questions.
- Developers and operations practitioners who want fuzzy or semantic search across command history.
- Terraform users who want to create or reuse provisioning templates from the CLI.
Documented uses
- Ask for a shell command by describing the task in plain English.
- Find previously used commands through indexed history and reverse search.
- Provide corrections or additional context while refining a command suggestion.
- Request next-action suggestions based on usage patterns.
- Index a file or website for assistant context.
Requirements & limits
The repository documents installation on Ubuntu, macOS through Homebrew, and through pip. The pip route requires Python 3.10 or later. The repository specifies a GPL-3.0 license.
- The pip installation path requires Python 3.10 or later; the README also provides Ubuntu and Homebrew installation routes.
- Extended reverse search is optional and documented as working only with Zsh.
- The documented infrastructure-template workflow currently targets Terraform.
- The repository describes the project as GPT-powered and provides a local runner command, but gives no further description of that runner in the README.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and configure um with pip
Set up the CLI using the documented pip installation path.
Before you start
- Python 3.10 or later
Steps
Install the package with the command below.
pip3 install promptopsRun
eval "$(um --install)"to configure um.
Expected outcome
The README’s documented pip installation and configuration steps are complete.
Guide limitations
- The Python version requirement applies to the pip installation instructions.
- These setup steps do not describe a specific command-query workflow.
Enable extended reverse search in Zsh
Add um’s documented extended reverse-search widget and key binding to Zsh.
Before you start
- um installed and configured
- Zsh
Steps
Back up
.zshrcwithcp ~/.zshrc ~/.zshrc.backup.Append
eval "$(promptops lookup --config)"to.zshrc.Reload the shell configuration with
source ~/.zshrc.
Expected outcome
The documented Ctrl+E extended reverse-search configuration is added to Zsh.
Guide limitations
- The README says this feature currently works only with Zsh.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- promptops/cli · Official homepage title · retained in its source language

