CLI 레퍼런스
Firma는 Claude 중심으로 설계돼 있어서 대부분은 초기 설치 후 CLI를 자주 건드릴 일이 없습니다. 그래도 모든 MCP 도구에는 대응되는 firma 명령어가 있어서 자동화, 스크립팅, 직접 터미널 작업이 필요할 때 바로 쓸 수 있습니다. 모든 read 명령은 --json도 지원합니다.
초기 설정
firma config set finnhub-key <key>Finnhub API 키 설정 (finnhub.io에서 무료 발급)firma config set fred-key <key>FRED API 키 설정 (fred.stlouisfed.org에서 무료 발급)firma config set currency <CODE>표시용 홈 통화 설정 (KRW, USD, JPY, EUR 등)firma config get [key]설정값 확인firma mcp installClaude Desktop 설정에 MCP 서버를 등록firma doctor설치 상태를 점검합니다. 키, 데이터, FX 캐시를 확인하고 문제가 있으면 해결 방법을 제안합니다.firma profile목표 인터랙티브 등록 (5개 항목, 모두 선택 입력)포트폴리오
firma show portfolio보유 종목, 손익, 평균 단가, 시가firma show txns [ticker]평균 단가 누적 변화가 포함된 거래 내역firma show dividend연간 배당 추정 + 종목별 배당 수익률firma show concentration티커, 통화, 섹터, 국가별 HHI 집중도firma show snapshot [ticker]포트폴리오 가치 이력. --from/--to로 기간 지정firma show benchmarkSPY/QQQ 대비 수익률. -b로 사용자 지정 벤치마크 사용firma show risk변동성, 드로다운, Sharpe, Sortino, 베타. 스냅샷 이력 필요firma show profile저장된 목표 (출생 연도, 은퇴 목표, 목표 순자산 등)자산 & 현금흐름
firma add balance [-p YYYY-MM]월별 자산 & 부채 스냅샷 입력 위저드firma add flow [-p YYYY-MM]월별 수입 & 지출 입력 위저드firma add monthly [-p YYYY-MM]자산과 현금흐름을 한 세션에서 함께 입력. 월말 정산에 잘 맞습니다.firma show balance [-p YYYY-MM]저장된 자산 항목 조회firma show flow [-p YYYY-MM]저장된 현금흐름 항목 조회firma report순자산 추세 + 현금흐름 차트 (통합)firma report balance / flow / settle개별 리포트. -c USD로 임의 통화 표시거래 & 스냅샷
firma add txn거래 1건 기록: 매수, 매도, 입고, 배당, 세금firma edit txn [id]거래 수정 (날짜, 수량, 가격, 사유)firma delete txn [id]거래 삭제firma add snapshot가격을 동기화하고 오늘의 포트폴리오 스냅샷 기록firma edit snapshot스냅샷 항목 수정 (인터랙티브 선택)firma delete snapshot [date]특정 날짜의 모든 스냅샷 항목 삭제데일리 브리핑 & 동기화
firma brief변동 종목, 뉴스, 실적 발표, 거시경제 맥락을 보여줍니다. 일별로 캐시되며, 오늘 스냅샷이 없으면 자동으로 기록합니다. --refresh로 다시 생성할 수 있습니다.firma sync최신 주가 (Finnhub) + 환율 이력 (FRED) 가져오기firma sync fx환율 이력만 갱신. 증분 백필 방식거시경제
firma show macroVIX, 10년물 금리, 장단기 스프레드, 달러 인덱스, HY 스프레드, 인플레이션, 연방기금금리, 환율firma show stress5개 FRED 시리즈 기반 경제 스트레스 지수 (0–100)firma show regime거시경제 레짐 편향. Risk-on / Mixed / Risk-offfirma show fx [currency]캐시된 환율 이력. --from/--to/--limit리서치
firma show news <ticker>최근 기업 뉴스firma show insider <ticker>내부자 매매 거래firma show financials <ticker>SEC 보고 분기 재무제표firma show earnings [ticker]실적 발표 캘린더 + EPS 이력팁
모든 read 명령에
--json 사용 가능Firma 출력을 jq, 스크립트, 다른 도구로 넘길 수 있습니다. Claude가 보는 데이터와 같은 형태, 같은 필드명입니다.
firma rm은 firma delete의 별칭삭제 명령에 짧은 형태를 사용할 수 있습니다.
~/.firma/firma.db의 로컬 SQLite모든 데이터는 단일 파일에 저장됩니다. 백업, 다른 컴퓨터로 복사, 또는 임의의 SQLite 클라이언트로 직접 열기가 가능합니다.