BTC Portfolio Manager

A CLI tool to analyze, simulate and manage your Bitcoin portfolio.

Features

• Real-time BTC price from CoinGecko API
• Portfolio analysis with profit/loss per purchase
• Price simulation for hypothetical scenarios
• Colored output (green for profits, red for losses)
• Configuration system with default file
• Export reports in Markdown or plain text

Installation

# Clone the repository
git clone https://github.com/caixetadev/btc.git
cd btc

# Build
make build

# Or install globally
make install

Configuration

Set a default CSV file to avoid passing it every time:

# Set default file
btc config -f portfolio.csv

# View current configuration
btc config

Configuration is stored in ~/.config/btc/config.json.

Usage

Check current BTC price

btc price

Analyze portfolio

# With default file configured
btc analyze

# Or specify a file (takes priority over config)
btc analyze portfolio.csv

Portfolio summary

btc summary

Simulate hypothetical price

btc simulate --price 150000

Export report

# Markdown format
btc export --format md > report.md

# Text format
btc export --format txt

Quick Start

An example file is included to test the tool:

btc analyze transactions.example.csv
btc summary transactions.example.csv
btc simulate --price 150000 transactions.example.csv

CSV Format

Create a CSV file with your purchases (see transactions.example.csv for reference):

date,btc_amount,usd_paid
2024-01-15T10:30:00,0.02,1200.00
2024-06-20T14:00:00,0.03,2300.00

Column	Description
date	Purchase date (ISO 8601 format)
btc_amount	Amount of BTC purchased
usd_paid	Amount paid in USD

Shell Completion

# Bash
btc completion bash >> ~/.bashrc

# Zsh
btc completion zsh >> ~/.zshrc

# Fish
btc completion fish > ~/.config/fish/completions/btc.fish

Development

# Build
make build

# Run tests
make test

# Format code
make fmt

# Build for all platforms
make build-all

Project Structure

btc/
├── main.go
├── transactions.example.csv  # Example portfolio for testing
├── cmd/
│   ├── root.go
│   ├── config.go           # btc config
│   ├── price.go            # btc price
│   ├── analyze.go          # btc analyze
│   ├── summary.go          # btc summary
│   ├── simulate.go         # btc simulate
│   └── export.go           # btc export
├── internal/
│   ├── config/
│   │   └── config.go       # Configuration management
│   ├── portfolio/
│   │   ├── csv.go          # CSV parser
│   │   └── portfolio.go    # Portfolio logic
│   ├── price/
│   │   └── api.go          # CoinGecko API client
│   ├── simulator/
│   │   └── simulator.go    # Price simulator
│   └── ui/
│       └── colors.go       # Terminal colors
├── Makefile
├── go.mod
└── go.sum