portfolio intelligence in your terminal

A multi-timeframe analytics engine for your portfolio. 19+ data sources, 4 intelligence layers, 100+ CLI commands, from intraday regime detection to decade-long structural cycles.

curl -fsSL https://raw.githubusercontent.com/skylarsimoncelli/pftui/master/install.sh | bash

Re-run to upgrade. Your data is preserved.

pftui

$ pftui

█

Why pftui

The intelligence layer between raw data and portfolio decisions, not another dashboard.

Analytics engine, not a dashboard

Four intelligence layers (LOW/MEDIUM/HIGH/MACRO) produce situation awareness, impact analysis, opportunity scoring, and cross-timeframe synthesis. This is the intelligence layer between raw data and portfolio decisions.

19+ sources, one command

Prices, CFTC positioning, COMEX inventory, BLS economic data, FedWatch rates, oil term structure, sovereign holdings, ETF flows, prediction markets, and on-chain metrics are all cached locally with pftui data refresh. No API keys required.

100+ CLI commands with `--json`

Every feature is a composable CLI primitive. Agents run pftui analytics situation for a full awareness payload. Humans open the TUI for visual depth. Both work from the same database.

Predictions with accuracy scoring

Make falsifiable calls, score outcomes, track your hit rate by conviction level and timeframe. The system tells you where you're calibrated and where you're overconfident.

See it in action

A quick look at pftui across the terminal UI, web dashboard, analytics views, and search.

Positions, live prices, allocation, sparklines, and interactive price chart

Buy/sell history with cost basis tracking

Macro indicators, regime detection, predictions, and economic calendar

Technical indicators, correlations, and portfolio analysis

Browser-based dashboard backed by the same local data

Global search across positions, watchlist, and market data

Install anywhere

Use the install script for the fastest path. Re-running it upgrades pftui while preserving your local data and config.

curl install script

Fastest path for Linux and macOS.

curl -fsSL https://raw.githubusercontent.com/skylarsimoncelli/pftui/master/install.sh | bash

Recommended setup

Ask Claude Code, Codex, or OpenClaw to install pftui and set it up with you. Your agent can read AGENTS.md, configure your watchlist, and walk you through the system.

Read AGENTS.md in the pftui repo: https://github.com/skylarsimoncelli/pftui

Install pftui, help me set up pftui with my portfolio and watchlist, and walk me through the functionality

For human operators

pftui’s core experience is a fast, keyboard-driven interface built for daily portfolio and market monitoring.

Terminal UI

Track positions, transactions, markets, macro, watchlists, news, and journal state in one place, with braille charts, fast navigation, and privacy mode built in.

Web dashboard

Use the same local data through a browser with responsive layouts, TradingView charts, click-through asset views, and auto-refreshing pages.

Daily workflow

Designed to replace scattered tabs and spreadsheets with one practical system you can actually live in every day.

For AI agents

Every major feature is available through the CLI with structured output, so agents can refresh data, inspect state, update research, and contribute to the same system the human operator uses.

Shared live state

Your agent can refresh market data, inspect portfolio state, manage watchlists, record notes, review macro conditions, and generate briefs through the same local database and CLI.

Automated workflows

Run morning briefs, market-close summaries, weekly reviews, scenario tracking, and monitoring loops without building a separate stack around the product.

Bidirectional collaboration

Agents do not just read data. They can update scenario probabilities, log evidence, set conviction scores, and write notes that remain reviewable and queryable over time.

Agent morning routine

$ pftui data refresh
19 sources updated, 84 symbols, regime classified

$ pftui analytics situation --json
{"regime": "risk-off", "watch_now": [...], "impacts": [...]}

$ pftui analytics impact --json
{"exposures": [{"symbol":"GC=F","consensus":"bullish","score":142}]}

$ pftui journal conviction set GC=F --score 4 --notes "War + BRICS"
Gold conviction: +4 (strong bullish)

Full agent guide: AGENTS.md AI layer docs: docs/AI-LAYER.md

Agent-ready CLI

Every major feature is available as a composable CLI primitive, with structured output available across the system.

$ pftui data refresh

✓ 19 sources • 84 symbols • regime classified • 371 signals computed

$ pftui analytics situation --json

REGIME: risk-off (75%) │ ALERTS: 3 critical │ ALIGNMENT: bearish 3/4 layers

$ pftui analytics impact --json

GC=F bullish (score 142) │ BTC bullish (score 154) │ USD lean-bull (score 51)

$ pftui analytics opportunities --json

CL=F bullish score:91 │ CCJ bullish score:80 │ HG=F bullish score:69

$ pftui analytics synthesis --json

ALIGN: GOOG bearish 3/4 │ DIVERGE: BTC bull/bear split │ GC=F bull/bear split

$ pftui analytics catalysts --json

🔴 GDP (Preliminary) Mar 26 │ Durable Goods Mar 25 │ PCE Apr 1

$ pftui data fedwatch --json

Apr 29: HOLD 62% / CUT 38% │ Jun 17: CUT 55% / HOLD 35% │ Jul 29: CUT 72%

$ pftui data oil-premium --json

WTI $98.32 BACKWARDATION │ Brent $106.41 │ Spread -$8.09 │ 🟡 MIXED STRUCTURE

$ pftui data sovereign --json

CB Gold: Italy 2452t │ Russia 2327t │ China 2306t │ Govt BTC tracked

$ pftui journal prediction stats --json

165 predictions │ 45% hit rate │ High conviction: 48.3% │ Low: 44.4%

$ pftui analytics alignment --symbol GC=F --json

GC=F │ LOW:bear │ MED:bull │ HIGH:bull │ MACRO:neutral │ MIXED (34%)

$ pftui portfolio brief --agent --json

{"value":287345,"pnl":3892,"movers":[...],"macro":{...},"regime":"risk-off"}

Data Aggregation Engine

One pftui data refresh pulls from 19+ data sources, caches everything locally, and runs pre-processing on top of the raw data. By the time anything else reads from the database, the heavy numerical work is already done.

What it collects

Equity, crypto, commodity, and forex prices across 84 symbols. CFTC Commitments of Traders positioning. COMEX warehouse inventory. BLS economic data across 101 series. World Bank indicators for 8 economies. Polymarket odds. Fear and Greed indices. Economic calendar. Financial news from RSS feeds and Brave Search. BTC on-chain data and ETF flows.

What it computes

RSI, MACD, SMA, and Bollinger Bands across all symbols. Rolling cross-asset correlation matrices. Market regime classification with confidence scoring. Daily change detection and threshold alerts. FX normalization for multi-currency portfolios. Prediction market probability shifts.

Why it matters

The Analytics Engine does not re-derive technicals from raw price data. It reads pre-computed indicators from the database and asks the higher-order question: what does RSI 89 on oil mean given the current war scenario? The aggregation layer handles compute. The analytics layer handles interpretation.

$ pftui data refresh

$ pftui data refresh

✓ Prices          (84 symbols, RSI/MACD/SMA computed)
✓ Correlations    (33 cross-asset pairs)
✓ Regime          (risk-off, confidence 0.85)
✓ FedWatch        (14 FOMC meetings priced)
✓ COT             (4 reports from CFTC)
✓ COMEX           (gold + silver inventory)
✓ Economy         (101 BLS series)
✓ Sovereign       (CB gold, govt BTC, COMEX silver)
✓ Predictions     (4 markets from Polymarket)
✓ News            (116 articles via Brave + RSS)
✓ On-chain        (ETF flows, BTC metrics)
✓ Oil structure   (term structure, war premium)

No API keys required for core sources Full pipeline docs: docs/DATA-AGGREGATION.md

Database

The shared state layer for everything. The aggregation engine writes price caches and economic data. The analytics engine writes scenarios and convictions. The AI layer writes agent messages and predictions. Every layer's output becomes queryable input for every other layer.

🏦

46 tables, one source of truth

Transactions, price history, COT positioning, COMEX inventory, BLS economic data, World Bank indicators, sentiment indices, prediction markets, scenarios, convictions, trend tracking, agent messages. All normalised, all queryable.

🔐

Full data sovereignty

SQLite by default, PostgreSQL for production. No cloud sync. No third-party accounts. Back it up, version it, query it directly. Your data stays yours.

📐

Shared state, not a pipe

An agent reads regime classification, combines it with scenario probabilities, and writes a conviction score consumed elsewhere in the system. The database is where all layers meet.

⚡

Compounds over time

Day one is a snapshot. Day thirty is a month of cross-asset history. Day three hundred is a proprietary dataset most retail investors never build. The longer you run it, the more powerful it becomes.

Multi-timeframe Analytics Engine

Four intelligence layers operating simultaneously across different time horizons. Each uses different data, updates at different frequencies, and produces different signals. When all layers align on an asset, that is the highest conviction signal in the system.

LOW: hours to days

Prices, volatility, sentiment, regime classification, correlations, calendar events, and triggered alerts. Updated every refresh cycle. Tactical signals: what is happening right now.

MEDIUM: weeks to months

Macro scenarios with probabilities, versioned thesis, conviction scores per asset, research questions, economic data, and user predictions with accuracy scoring. Updated daily. Directional signals: which narratives are winning.

HIGH: months to years

Structural trends like AI disruption, nuclear renaissance, and commodity supercycles. Each trend has a direction, evidence log, and per-asset impact mapping. Updated weekly. Thematic signals: what forces are reshaping markets.

MACRO: years to decades

Empire lifecycle analysis with power metrics across 8 dimensions, structural cycles with stage tracking, long-term outcome probabilities, and historical parallels. Updated weekly. Structural signals: where are we in the big cycle.

$ pftui analytics summary

$ pftui analytics summary

LOW       risk-off regime | VIX 29.5 | 3 alerts triggered | 7 movers
MEDIUM    war scenario 45% | gold conviction +4 | Fed 75bp pricing
HIGH      commodity supercycle accelerating | AI displacement evidence
MACRO     US Stage 5 to 6 transition | 1973 parallel similarity 8/10

ALIGNMENT: gold bullish across all four timeframes

Signals flow upward through layers. Context flows downward. Full docs: docs/ANALYTICS-ENGINE.md

Why operators switch

	pftui	Yahoo Finance	Bloomberg Terminal	Spreadsheets
Live Prices	✓	✓	✓	Manual
Charts	Braille + TradingView	Basic	Professional	No
Technical Analysis	✓	Limited	✓	Manual
Macro Dashboard	✓	No	✓	No
Runs in Terminal	✓	No	No	No
Privacy	Local SQLite or your Postgres	Cloud	Enterprise	Local
Persistent Local DB	46 tables, compounds daily	No	Proprietary	Manual
Agent-ready CLI	100+ commands, structured output	No	Bloomberg API ($)	No
Data Centralisation	19+ sources, one refresh	1 source	✓	Manual
Multi-Timeframe Analytics	LOW / MEDIUM / HIGH / MACRO engine	No	Partial	No
AI Agent Integration	✓	✗	✗	✗
AI Layer Workflows	Briefs, scenarios, conviction loops	No	Custom build	Manual
Cost	Free	Free	$24k/year	Free

portfolio intelligence in your terminal

Why pftui

Analytics engine, not a dashboard

19+ sources, one command

100+ CLI commands with `--json`

Predictions with accuracy scoring

See it in action

Install anywhere

curl install script

Recommended setup

For human operators

Terminal UI

Web dashboard

Daily workflow

For AI agents

Shared live state

Automated workflows

Bidirectional collaboration

Agent-ready CLI

Architecture

Data Aggregation Engine

What it collects

What it computes

Why it matters

Database

46 tables, one source of truth

Full data sovereignty

Shared state, not a pipe

Compounds over time

Multi-timeframe Analytics Engine

LOW: hours to days

MEDIUM: weeks to months

HIGH: months to years

MACRO: years to decades

Why operators switch

Daily Intelligence Reports

Built in the open

portfolio intelligence in your terminal

Why pftui

Analytics engine, not a dashboard

19+ sources, one command

100+ CLI commands with --json

Predictions with accuracy scoring

See it in action

Install anywhere

curl install script

Recommended setup

For human operators

Terminal UI

Web dashboard

Daily workflow

For AI agents

Shared live state

Automated workflows

Bidirectional collaboration

Agent-ready CLI

Architecture

Data Aggregation Engine

What it collects

What it computes

Why it matters

Database

46 tables, one source of truth

Full data sovereignty

Shared state, not a pipe

Compounds over time

Multi-timeframe Analytics Engine

LOW: hours to days

MEDIUM: weeks to months

HIGH: months to years

MACRO: years to decades

Why operators switch

Daily Intelligence Reports

Built in the open

100+ CLI commands with `--json`