tui

name	tui
description	Use the agent-finance selected-symbol terminal for live quotes, OHLCV charts, account views, diagnostics, and staged trading workflows with keyboard or mouse.

agent-finance TUI

Use the TUI for live monitoring, visual OHLCV inspection, account review, and deliberate trade preparation. Use market ... --json or tui --dump-state --json when an agent needs a stable structured contract instead of screen text.

Launch

agent-finance tui --symbols AAPL,CRDO,BTCUSDT
agent-finance tui --symbols CRDO,LITE,AAOI --chart-preset auto
agent-finance tui --symbols BTC/USDT,ETH/USDT --chart-preset 1d
agent-finance tui --symbols CRDO --profile default
agent-finance tui --symbols CRDO --no-persist
agent-finance tui --symbols CRDO --dump-state --json

The TUI persists the watchlist, refresh cadence, provider, chart, theme, locale, and selected trading profile unless --no-persist is used. It always opens with a clean Market workspace rather than restoring obsolete window geometry.

Surface Model

• Market is the primary selected-symbol terminal: symbol header and quote, large chart, compact watchlist, and a capability-driven right rail for sessions, evidence, research, or prediction signals.
• The pencil in the watchlist title opens its editor. Add or remove symbols, drag rows to reorder them, then undo or save in the same overlay; editing order does not change the selected market symbol.
• Orders owns open orders and cancel/trade entry. It does not duplicate the Market chart.
• Portfolio owns balances, holdings, positions, and explicit transfer/futures-state entry points.
• Research groups evidence, news, and prediction-market context.
• Settings keeps persistent preferences concise. Account Setup and Profile / Risk open as focused overlays.
• Trade Drawer opens from the symbol header, chart reference, watchlist, holding, or open-order row. Diagnostics combines health, routes, realtime state, and task activity in one tabbed overlay.

Use : for the command palette, / for symbol search, p for Diagnostics, and Esc to close the top focused overlay. Only interactive rows and controls highlight under the mouse.

Realtime And Provider Evidence

• Routing is capability-first and shared with market ... commands.
• For US equities and ETFs, auto prefers Binance Stocks WebSocket when available. Read the visible provider, session, latency, and fallback status; a configured preference alone does not prove which source is active.
• Eligible equity watchlist symbols share one realtime session. connected proves the WebSocket transport is up; live additionally requires a fresh update for the selected symbol. Switching a covered symbol should not reconnect, and an old market timestamp must not be treated as fresh data.
• WebSocket failure may fall back to REST. Diagnostics exposes reconnect, gap, route-health, and task evidence; it is not a substitute for a current quote or candle series.
• Crypto realtime starts only when the resolved provider exposes the required stream capability.
• Chart presets are provider-aware. Record the displayed provider, actual range, actual interval, session, and bar count after fallback.

Chart

• The selected-symbol chart renders OHLCV candles and volume in the same terminal columns. Hover shows crosshair plus O/H/L/C/V without erasing the candle.
• Wheel zooms the visible window; drag selects a time window; h/l or arrows move the candle cursor; [/] zoom.
• Toolbar controls change range, interval, and glyph mode. Unsupported provider intervals remain visible but disabled.
• j/k selects visible price references such as current price, previous close, day O/H/L, open orders, or position entry. Enter copies the selected price into the Trade Drawer.
• Clicking a chart price only fills a draft. It never stages, submits, or enables live writes.
• When the provider returns close-only data, treat the chart as degraded and verify with another capable provider before relying on intrabar shape.

Trade Drawer

The workflow is draft -> local validation -> risk summary -> stage -> review -> confirmation -> existing submit path -> audit.

• Entry context may safely prefill symbol, market, side, remaining quantity, price, order kind, TIF, reduce-only, or position side. Prefill is never submission.
• Unsupported fields and operations are hidden or disabled with a capability, permission, or profile reason. Do not infer support from a visual placeholder.
• s stages a valid draft; review remains inside the drawer. Market/live/transfer/futures-state/high-risk operations retain stronger confirmation, including typed confirmation where required.
• Open-order cancel uses the staged cancel path. Replace/amend and compound protective orders appear only when a provider capability truly exists.
• The renderer and input path never call provider writes directly. Never use funded live orders as a UI test.

For signed workflows, load the profile guide first:

agent-finance skills get profile --full

Agent Contract

agent-finance tui --symbols CRDO --dump-state --json

The dump exposes selected-symbol market state, Trade Drawer open/phase/source/draft/risk summary, staged changes, pending confirmation, profile validation, account snapshots, realtime diagnostics, route diagnostics, and task events. Prefer this contract over OCR or terminal scraping.

For any entry, stop-loss, take-profit, or order-quality decision, inspect both daily and minute history. Preserve actual provider/session/range/interval evidence and refresh stale account snapshots before relying on order or position overlays.