Real shell wrapper
Keep your existing bash or zsh behavior, including directory changes and interactive commands.
Local-first terminal assistance
Command suggestions inside the shell you already use.
zFlow wraps your real bash or zsh session, learns from local history, and previews the commands you are likely to need next. You stay in control of what runs.
$ zflow
running your real zsh session...
$ git
[ SUGGESTIONS ]
<1> git status
<2> git pull --rebase
<3> git log --oneline -5
Select a candidate to fill the input. Execute only when you decide.
Demo video
A concise walkthrough of start, suggest, and select.
The promo video shows the core interaction loop: start zFlow, get recommendations, choose a candidate, execute it, and switch between Bottom and Inline modes.
Features
Designed for people who already live in the terminal.
Local learning
Import shell history and build a recommendation index on your machine.
Preview-first suggestions
Suggestions fill the input by default, so execution stays under your control.
Retrieval-assisted recall
Surface relevant commands from previous workflows, even when they were used elsewhere.
Evaluation built in
Use local history to compare recommendation strategies with top-k and MRR metrics.
Configurable behavior
Tune retrieval, adaptive feedback, and Enter behavior from a local config file.
Workflow
Start, learn, evaluate.
zFlow is intentionally small: install it, launch the TUI, let it learn from local shell history, then evaluate whether recommendations improve your own workflow.
npm install -g zflow-cli
zflow
zflow learn
zflow eval
Privacy
Local-first by default.
zFlow reads local shell history to generate suggestions and stores learning data under
~/.config/zflow/. Command history and recommendation indexes are not uploaded
by default.
Install
Try zFlow with npm.
npm install -g zflow-cli
zflow --version
zflow
For a temporary run, use npx zflow-cli. The main npm package selects the
appropriate macOS binary package automatically.