igoropaniuk

igoropaniuk / stonks-cli

Public

A terminal-based investment portfolio tracker. Displays your holdings with live market prices, unrealized P&L, and a total portfolio value

cli cryptocurrency etf finance markets
16
0
100% credibility
Found Mar 14, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A terminal dashboard tool for tracking personal stock portfolios with live market prices, profit/loss calculations, and multi-currency support using public financial data.

How It Works

1
📱 Discover Stonks

You hear about a handy tool that lets you check your stock investments right from your computer's command window, no fancy apps needed.

2
⬇️ Get It Set Up

You easily add the tool to your computer so it's ready to use anytime.

3
📝 List Your Holdings

You create a simple list of your stocks, how many shares you own, what you paid, and their currencies.

4
➕ Add Your Stocks

You tell the tool about each stock you own, like adding shares of Apple or Toyota, and it keeps track automatically.

5
📊 Open the Dashboard

You launch the colorful screen that shows all your stocks with live prices updating every few seconds.

6
🔄 Watch Values Change

You see the current worth of everything in dollars, plus gains or losses highlighted in green or red, feeling in control.

🎉 Track Effortlessly

Now you can quickly peek at your portfolio anytime, add or remove holdings, and stay updated on your investments without leaving your desk.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is stonks-cli?

Stonks-cli is a Python CLI for tracking your investment portfolio right in the terminal, displaying holdings with live market prices including extended-hours quotes, unrealized P&L, and total portfolio value in USD. It uses Yahoo Finance data with no API token needed, supports global tickers like ASML.AS or 7203.T, and manages positions via simple YAML config. Fire up `stonks dashboard` for a TUI table that refreshes every few seconds, or use `add` and `remove` commands to update holdings and cash across currencies.

Why is it gaining traction?

It stands out with dead-simple pipx install, Docker support, and automatic forex conversion for multi-currency portfolios—no paid APIs or complex setup. The TUI shows session tags like PRE or AH trading, plus weighted average cost tracking on adds, making it a quick stonks cli for live glances. Devs dig the terminal-based flow over bloated web apps or mobile trackers.

Who should use this?

CLI diehards monitoring personal stocks across US, Europe, and Asia exchanges. Python scripters building trading bots who need a lightweight portfolio viewer. Remote workers preferring geneva-based terminal investment tools without browser tabs.

Verdict

Try it for a no-fuss stonks tracker if you live in the shell—docs are solid with exchange lists and samples—but its 1.0% credibility score and 16 stars signal early days, so expect tweaks for production use. Solid prototype, not daily driver yet.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.