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 순서 변경, 실행 취소, 저장을 할 수 있으며 순서만 바꿀 때는 차트의 선택 종목이 바뀌지 않습니다.
• Orders는 미체결 주문과 취소·거래 진입을 담당하며 Market 차트를 중복 표시하지 않습니다.
• Portfolio는 잔고, 보유 자산, 포지션, 이체·선물 상태 진입을 담당합니다.
• Research는 근거, 뉴스, 예측 시장 정보를 모읍니다.
• Settings는 영구 설정만 간결하게 유지하고 Account Setup과 Profile / Risk는 전용 overlay로 엽니다.
• 거래 드로어는 종목 헤더, 차트 기준가, 관심 목록, 보유 자산, 미체결 주문에서 열립니다. 진단은 health, routes, realtime, tasks를 하나의 탭 overlay로 합칩니다.

:는 명령 팔레트, /는 종목 검색, p는 진단, Esc는 맨 위 overlay 닫기입니다. 마우스에서는 실제로 조작할 수 있는 행과 컨트롤만 강조됩니다.

실시간 및 Provider 근거

• 라우팅은 capability-first이며 market ... 명령과 동일한 정책을 사용합니다.
• 미국 주식과 ETF의 auto는 사용 가능할 때 Binance Stocks WebSocket을 우선합니다. 화면에 표시된 provider, session, latency, fallback을 확인해야 하며 설정 선호만으로 실제 소스를 단정하면 안 됩니다.
• 지원되는 미국 주식은 관심 목록 전체가 하나의 realtime session을 공유합니다. 연결됨은 WebSocket transport 연결을 뜻하고, 실시간은 선택 종목의 최신 업데이트까지 받은 경우에만 표시합니다. 같은 session 안의 종목 전환은 재연결하지 않으며 오래된 market timestamp를 최신 데이터로 취급하지 않습니다.
• WebSocket 장애 시 REST로 대체될 수 있습니다. 진단은 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이나 터미널 문자열 파싱보다 이 계약을 우선합니다.

진입, stop-loss, take-profit, 주문 품질 판단에는 일봉과 분봉을 모두 확인합니다. 실제 provider/session/range/interval을 보존하고 주문·포지션 overlay를 신뢰하기 전에 오래된 계정 snapshot을 갱신합니다.