tui

name	tui
description	agent-finance の銘柄別ターミナルでリアルタイム気配、OHLCV チャート、口座、診断、段階的な取引フローをキーボードまたはマウスで扱います。

agent-finance TUI

リアルタイム監視、OHLCV の目視確認、口座確認、慎重な取引準備に TUI を使います。Agent が安定した構造化データを必要とする場合は、画面文字列ではなく market ... --json または tui --dump-state --json を使います。

起動

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

--no-persist を指定しない限り、ウォッチリスト、更新間隔、provider、チャート、テーマ、言語、選択中の取引 profile を保存します。廃止されたウィンドウ配置は復元せず、毎回整理された Market ワークスペースから始まります。

画面構成

• Market は銘柄別の中心画面です。銘柄ヘッダーと気配、大きなチャート、コンパクトなウォッチリスト、capability に応じた sessions / evidence / research / 予測シグナルの右 rail を表示します。
• ウォッチリスト見出しの鉛筆から編集 overlay を開けます。同じ画面で銘柄の追加・削除、drag による並べ替え、undo、保存を行えます。並べ替えだけではチャートの選択銘柄は変わりません。
• Orders は未約定注文と取消・取引の入口を担当し、Market のチャートを重複表示しません。
• Portfolio は残高、保有銘柄、ポジション、振替・先物状態の明示的な入口を担当します。
• Research はエビデンス、ニュース、予測市場の情報をまとめます。
• Settings は永続設定を簡潔に保ち、Account Setup と Profile / Risk は専用 overlay で開きます。
• 取引ドロワー は銘柄ヘッダー、チャート参照価格、ウォッチリスト、保有銘柄、未約定注文から開きます。診断は health、routes、realtime、tasks を 1 つのタブ付き overlay にまとめます。

: でコマンドパレット、/ で銘柄検索、p で診断、Esc で最上位 overlay を閉じます。マウスでは実際に操作できる行とボタンだけがハイライトされます。

リアルタイムと Provider

• ルーティングは capability-first で、market ... コマンドと共通です。
• 米国株と ETF の auto は、利用できる場合 Binance Stocks WebSocket を優先します。表示中の provider、session、latency、fallback を必ず確認してください。設定上の選択だけでは実データ源を確定できません。
• 対象となる米国株はウォッチリスト全体で 1 つの realtime session を共有します。接続済み は WebSocket transport の確立を示し、ライブ は選択銘柄の新しい更新も受信した場合だけ表示します。Session 内の銘柄切替で再接続せず、古い market timestamp を新鮮な値として扱いません。
• WebSocket 障害時は REST に fallback する場合があります。診断には reconnect、gap、route health、task が出ますが、現在値やローソク足の代わりにはなりません。
• Crypto realtime は、解決された provider が必要な stream capability を持つ場合だけ開始します。
• Chart preset は provider に合わせて変換されます。fallback 後の実際の provider、range、interval、session、bar 数を記録してください。

チャート

• OHLCV のローソク足と volume は同じターミナル列に描画されます。Hover してもローソク足を消さず、crosshair と O/H/L/C/V を表示します。
• Wheel で表示範囲を拡大縮小、drag で期間選択、h/l または矢印で cursor 移動、[/] で zoom します。
• Toolbar から range、interval、glyph mode を変更できます。Provider が未対応の interval は表示されますが操作できません。
• j/k で current price、previous close、当日 O/H/L、未約定注文、取得価格などの参照線を選び、Enter で取引ドロワーへコピーします。
• チャート価格のクリックは下書きへの入力だけです。Stage、submit、live write の有効化は行いません。
• Close-only データは劣化表示として扱い、intrabar の形を判断する前に OHLCV 対応 provider で検証します。

取引ドロワー

フローは 下書き -> ローカル検証 -> リスク要約 -> ステージ -> 確認 -> 承認 -> 既存の送信経路 -> 監査 です。

• 入口に応じて symbol、market、side、未約定数量、price、order kind、TIF、reduce-only、position side を安全に入力できます。自動入力は送信ではありません。
• 未対応の項目や操作は非表示または無効になり、capability、permission、profile の理由を示します。
• s で有効な下書きをステージし、確認もドロワー内で続けます。Market/live/transfer/futures-state/高リスク操作では、必要に応じて文字入力を含む強い確認を維持します。
• 注文取消は staged cancel を通ります。Replace/amend や複合保護注文は、provider が実際に capability を持つ場合だけ表示します。
• Render/input から provider write を直接呼びません。資金のある実注文を UI テストに使ってはいけません。

署名付き操作の前に profile ガイドを読みます。

agent-finance skills get profile --full

Agent 向け構造化状態

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

Dump には銘柄別 market state、取引ドロワーの open/phase/source/draft/risk summary、staged changes、pending confirmation、profile validation、口座 snapshot、realtime/route diagnostics、task events が含まれます。OCR や端末文字列の解析より、この契約を優先します。

Entry、stop-loss、take-profit、注文品質を判断する場合は、日足と分足を両方確認します。実際の provider/session/range/interval を保存し、注文・ポジション overlay を使う前に古い口座 snapshot を更新します。