Skip to content

Repository files navigation

pfpeek

⚡ Features

  • 📊 Graphical display of your portfolio performance, both today and since you began investing.
  • 📈 Overall metrics: Profit/Loss, Day change, Portfolio cost, and Current value.
  • 📋 Directa Integration: Place your latest "Movimenti" CSV export file from Directa (a sample file is included) in the script directory to unlock:
    • 💰 Money-Weighted Return Rate (MWRR) & Time-Weighted Return Rate (TWRR)
    • 💸 Total expenses & number of trades
    • 📊 Open and closed positions summary
    • 🔄 Total deposited and withdrawn funds to date
    • 💵 Realized gains from closed and partial positions
  • 🔍 Asset breakdown: For each portfolio asset, view its type (Equity, Bonds, Commodity, Money Market), ticker, full name, quantity, average cost, current price, current value, weight %, and individual P/L (overall & daily).
  • 📂 Flexible input: Assets are read from 2 CSV file: one is the Directa CSV export which you should overwrite when needed, the other one can be manually edited with all your transactions not managed through Directa.
  • 🖥️ Adaptive console layout: Dynamic text wrapping designed for terminal windows. Tall is better to fit all output without scrolling; fullscreen is ideal. Try also adjusting font size (usually Ctrl + mousewheel works).
  • 🌐 Real-time data: Fetches live market quotes directly from the web.
  • 💻 Cross-platform PowerShell support: Runs smoothly on modern Win10/11 environments, compatible with both PowerShell 5.1 and PowerShell 7+.

❓ Why

This project exists because I love Ticker and wanted some more details right on my screen.

It was also a fun test to see if all the hype around "vibe coding" held up...
Spoiler: It actually did! 🚀

It all started as an experiment: dropping a Ticker screenshot into Claude and asking it to write a PowerShell script to replicate the view, "let's see what happens..."
2 minutes later, I had a working draft!

From there, I decided to bring in some of the missing features I enjoy in Yahoo Finance web interface directly to my beloved terminal:

  • 📉 Performance charts
  • 📄 Directa CSV parsing and historical metrics
  • 🎨 Fine-tuned cosmetic tweaks (because I'm a f'ing perfectionist sometimes)

...And 38 iterations later (hence starting with v1.38), built during small pockets of free time, it’s ready to share!

💡 Suggestions Welcome

Feel free to open an Issue to share ideas for new features, improvements, or to report any bugs you spot.

⚠️ Disclaimer

I invest in Italy, holding long-term ETFs only.
The metrics displayed reflect the specific data points I care about daily. It might work with crypto, individual stocks, or bonds, but it hasn't been tested for those asset classes yet — give it a try!

About

Your portfolio in a supernerdy console. All text. No BS.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Contributors

Languages