TickerTrail is a terminal app for tracking stocks and indices, comparing performance, and managing watchlists.

It works well for India-first workflows (.NS/NSE aware) and also supports global symbols.

Install uv first (if not already installed):

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version

macOS (Homebrew alternative):

brew install uv
uv --version

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv --version

Then clone and run:

git clone https://github.com/vsjha18/tickertrail.git
cd tickertrail
uv sync
uv run tickertrail

Check live quote snapshots
View swing and intraday charts in terminal
Compare stocks vs benchmark (cmp, t, tt)
Open index boards and constituent snapshots (index, snap)
Inspect stock and index F&O chains and drill into one strike with live Upstox prices and Greeks (chain / oc, opt / option)
Review consolidated company fundamentals from Upstox (fundmentals / funda)

cli.py: entry point, compatibility adapters, and REPL controller orchestration
commandparser.py: typed, network-free command grammar shared by CLI entry points
replhelp.py: data-driven REPL overview, topic, command, and alias help
upstoxservice.py: Upstox token persistence, contract-calendar resolution, API normalization, and ATM-window selection
fundamentals.py: Upstox company-fundamentals normalization, derivations, and terminal dashboard rendering
indexconfig.py: canonical index aliases, board membership, fetch mappings, and prompt labels

vsjha18/tickertrail

Installation