4 KiB
The interactive TUI
zfin i # or: zfin interactive
The TUI is a multi-tab terminal interface over the same engine and data
files as the CLI. With no arguments it auto-loads portfolio.srf and
opens on the Portfolio tab; zfin i -s AAPL opens on the Quote tab for
a symbol. See zfin interactive for launch flags.
Tabs
Nine tabs, in order. Some show your whole portfolio; others show the currently-selected symbol.
| Tab | Scope | Shows |
|---|---|---|
| Portfolio | portfolio | Positions, valuations, cash, watchlist (like portfolio). |
| Analysis | portfolio | Allocation breakdowns and umbrella exposure (like analysis). |
| Review | portfolio | Per-holding performance/risk dashboard with findings (like review). |
| Projections | portfolio | Percentile bands, safe withdrawal, and the actuals overlay (like projections). |
| History | portfolio | Portfolio-value timeline from snapshots (like history). |
| Quote | symbol | Latest price and chart for the selected symbol (like quote). |
| Performance | symbol | Trailing returns and risk metrics for the symbol (like perf). |
| Earnings | symbol | Earnings history and upcoming events (like earnings). |
| Options | symbol | Options chain for the symbol (like options). |
The symbol-scoped tabs follow a single "current symbol"; change it from
the Portfolio tab (select a holding) or by launching with -s.
Charts
Tabs with charts render high-fidelity Kitty graphics when your
terminal supports them, falling back to braille otherwise. Force a mode
with --chart auto|braille|WxH. The Projections tab is the
highest-fidelity surface for the actuals overlay and the
convergence/return-backtest views.
Default keybindings
Press ? any time for the in-app overlay (it always reflects your
current bindings). The global defaults:
| Key(s) | Action |
|---|---|
q, Ctrl-C |
Quit |
r, F5 |
Refresh the current tab's data |
l / right / tab |
Next tab |
h / left / shift+tab |
Previous tab |
1-8 |
Jump to a tab by number |
j / down, k / up |
Move the selection |
g / G |
Jump to top / bottom |
Ctrl-d / Ctrl-u |
Half-page down / up |
page_down / Ctrl-f, page_up / Ctrl-b |
Page down / up |
Individual tabs add their own actions (e.g. the Projections tab's d
to set an as-of date and o to toggle the overlay). The ? overlay
and zfin i --default-keys list every binding, global and tab-scoped.
Customizing
Both keys and colors are configurable via files in ~/.config/zfin/:
zfin i --default-keys > ~/.config/zfin/keys.srf
zfin i --default-theme > ~/.config/zfin/theme.srf
See Customize the TUI, the
keys.srf reference, and the
theme.srf reference.