Output

How the CLI shapes what you see — output kinds, prompt config, watch modes, fill notifications, connection dots.

Output kinds

Every line the CLI prints carries a PrintKind. Listener cmd:output frames expose the same kind to web clients.

Kind	Color	Listener field	Goes to log file?
`print`	default	`print`	terminal only
`success`	green	`success`	terminal only
`info`	gray	`info`	terminal only
`warn`	yellow	`warn`	terminal only
`error`	red	`error`	terminal only

Where each stream goes:

logger.info / warn / error / debug → ~/.tealstreet/cli.log only — never the terminal.
console.log / info → the log file always, and the terminal only if it isn't operational noise. Routine exchange-WebSocket chatter (keepalive pings, reconnect notices, balance-stream dumps) is classified as operational and kept off the terminal — it still lands in cli.log. Everything else prints above the prompt (readline-aware, so async output never shreds what you're mid-typing).
console.warn / error → log file + printed above the prompt, and the latest one is mirrored on the top status bar.
console.debug → log file only when DEBUG=1 / DEBUG=true is set; dropped otherwise (it routes to logger.debug, gated by MIN_LOG_LEVEL, which defaults to info).
print() / originalConsoleLog() → terminal only, no rate limit — what command handlers use for primary output.

Verbose HoW/tradetunnel request diagnostics also use the existing console pipeline: start the CLI with DEBUG=1 or DEBUG=true to add sanitized [TradeTunnel] request/response summaries to the same ~/.tealstreet/cli.log. The [TradeTunnel] prefix is classified as operational, so these lines stay off the terminal. This is off by default, does not create a second network log file, omits headers, redacts sensitive keys, preserves URL query-key names without query values, and truncates large payloads.

The operational / info / warn / error / critical taxonomy lives in apps/cli/src/log-classify.ts; routing in apps/cli/src/logger.ts. View the full log with the logs / log command, or tail ~/.tealstreet/cli.log (yarn logs in dev). The file is cleared on every startup.

Source: apps/cli/src/listener/adapter-context.ts:13, apps/cli/src/logger.ts, apps/cli/src/log-classify.ts.

Hook output

Each cmd:output frame produced by a webhook fire is also mirrored to the local REPL with a [hook:<name>] prefix in the matching chalk color.

Two pinned single-line surfaces frame the scrolling output, both reserved via one shared ANSI scroll region (so they never fight each other or corrupt the prompt):

Top alert bar — transient. Mirrors the latest notable event (warn / error / critical) with category colour, then dims a few seconds after it lands so it stays glanceable without nagging. Routine info / operational lines never appear here (they'd flicker it), so a real error still surfaces even if the scrollback has moved on. A dimmed divider separates it from the content once an alert has fired.
Bottom footer — always-on (opt out with footer off). A customizable, glanceable status line: connection, account, symbol, balance, PnL, clock, CLI version, literal text, and custom-script segments. Arrange it with the footer command; the layout persists in the footer config block. A dimmed divider sits above it.

Both no-op on a non-TTY (pipes / CI) and suspend/resume cleanly around watch-mode alt-screen. Source: apps/cli/src/scroll-region.ts (the single region owner), status-line.ts, footer.ts, footer-segments.ts.

Command audit & tracing

Distinct from terminal output, the CLI can keep a durable, append-only record of every write-op (orders / cancels / closes / leverage) — including failures and script-driven writes — with a shared runId per typed line and fills attributed back to the command that placed them. Off by default; written to ~/.tealstreet/audit.log (separate from cli.log). See the audit command.

Prompt

The REPL prompt is fully configurable. View it with prompt, set it with prompt set "<format>".

prompt                          # show current
prompt list                     # show all named presets
prompt preset <name>            # switch to a preset
prompt set "{symbol} ${price} > "
prompt prefix <p>               # change the leading "> " marker
prompt preview                  # render the current format with live data

Tokens

Token	Renders
`{symbol}`	Focused symbol
`{account}`	Account name
`{price}`	Last price for focused symbol
`{side}`	Position side (`L` / `S` / `—`)
`{size}`	Position size
`{entry}`	Entry price
`{pnl}`	Unrealized PnL (currency)
`{pnl%}`	Unrealized PnL (percent)
`{liq}`	Liquidation price
`{leverage}`	Current leverage
`{orders}`	Open order count
`{conn}`	Connection health glyph (see below)

Alias ps works for prompt. Source: PromptCommand.ts.

Watch modes (standalone-only)

Live, full-screen views that refresh every 1000 ms.

Alias	Long forms	Shows
`wa`	`watch account`, `watch acc`	Margin + positions + orders combo
`wp`	`watch positions`, `watch pos`	Live positions table
`wo`	`watch orders`, `watch ord`	Live orders table
`wm`	`watch margin`, `watch balance`, `watch bal`	Live margin
—	`watch chart` (shorthand `watch c <args>`)	Live ASCII candlestick
—	`watch chase`	Live chaser status panel

wa, wp, wo, wm all accept --all / -a for the multi-account view.

Exit keys

Context	Keys
REPL mode	`Escape`, `Ctrl+X`
One-shot CLI	`Ctrl+C`, `Escape`, `Ctrl+X`

(In the REPL, Ctrl+C is reserved for readline line-cancel.)

Terminal recovery

Watch modes use the alt screen + raw mode. On exit the CLI runs recreateReadline() because readline state can corrupt across raw-mode toggles. There's a 200 ms cooldown (MONITOR_EXIT_COOLDOWN_MS) where prompt updates are skipped — that's intentional, not a freeze. Source: apps/cli/src/repl.ts:280-330.

Web parity

Watch modes are standalone-only. The web app has its own live panels (positions table, orders panel, etc.) rendered as components, not as a terminal canvas.

Connection health

The {conn} prompt token and accounts listings render colored dots:

Color	Meaning
Green	Healthy
Yellow	Warning / initializing
Red	Error / disconnected
Gray	Not connected

Driven by getConnectionStatus(exchange) from ConnectionMonitor. Force a fresh socket with conn reconnect.

Fill notifications

Every fill on the active exchange produces a one-liner:

✓ Fill: Bought 0.01 BTC-PERP @ $50,124.5

When you're inside a watch mode, the fill is appended via addWatchMessage to whichever panel is up. Source: apps/cli/src/repl.ts:850-858.

Critical error suppression

Per-account critical errors (geo-blocked, invalid API key, etc.) are classified by HealthMonitor and only printed once per category. If your error scrolled by an hour ago, check cli.log — it's still in there. Source: apps/cli/src/repl.ts:872-884.

Network monitor + rate limiting

The CLI intercepts console.* (apps/cli/src/logger.ts) and applies, in order: operational-noise suppression (operational lines go to cli.log only — see Output kinds), then a 5 messages / second rate limit with a 10 s dedup window on whatever remains, then readline-aware printing above the prompt. print() and the unwrapped originalConsoleLog() bypass all of this and are what command handlers use for primary output. The interceptor is the main defense against runaway third-party / WebSocket logging shredding the prompt.

Output kinds​

Hook output​

Status bar + footer​

Command audit & tracing​

Prompt​

Tokens​

Watch modes (standalone-only)​

Exit keys​

Terminal recovery​

Web parity​

Connection health​

Fill notifications​

Critical error suppression​

Network monitor + rate limiting​