Skip to content

About

Track Go Plus is a local-first personal expense tracker CLI. It helps users track daily expenses such as food, travel, rent, and bills.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python Version License Last Commit PRs Welcome

Track Go Plus 🚀

A lightning-fast, local-first personal expense tracker for your terminal.
100% Privacy. No Cloud. Just pure tracking.


📖 About the Project

Track Go Plus is a lightweight Command Line Interface (CLI) tool designed to help you track your daily expenses, manage budgets, and analyze your spending habits without relying on cloud-based apps.

Built with Python and powered by a local SQLite database, your financial data stays entirely on your machine. It is perfect for developers, terminal enthusiasts, and privacy-conscious users who want quick access to their expense logs without opening a heavy mobile app.

✨ Features

  • ⚡ Blazing Fast CLI: Add and view expenses in milliseconds.
  • 🔒 Local-First Privacy: Data is stored locally via SQLite. Zero cloud sync.
  • 📊 Smart Summaries: Generate category-wise and monthly spending summaries.
  • 📁 CSV Export: Easily export your financial data for Excel or tax purposes.
  • 🗓️ Date & Category Filtering: Quickly find exactly what you spent and when.
  • 🧪 Well-Tested: Comprehensive pytest coverage to ensure reliability.

🚀 Quick Start

Prerequisites

  • Python 3.10 or higher
  • Git

Installation

  1. Clone the repository:

    git clone https://github.com/khdcoder/Track-Go-Plus.git
    cd Track-Go-Plus
  2. Set up a virtual environment:

    python -m venv .venv
    
    # On Windows (PowerShell)
    .venv\Scripts\Activate.ps1
    
    # On macOS/Linux
    source .venv/bin/activate
  3. Install the package:

    pip install -e ".[dev]"

🛠️ Usage

Once installed, you can use the trackgo command from anywhere in your terminal.

1. Initialize the Database

Set up your local SQLite database before your first use.

trackgo init

2. Add an Expense

Log your daily spending with a category and a note.

trackgo add --amount 45.50 --category food --note "Lunch at cafe"
trackgo add --amount 1200 --category rent --date 2026-11-01

3. List Expenses

View your recent transactions.

trackgo list
trackgo list --category travel --limit 10

4. View Summaries

Get a breakdown of your spending by category.

# All time summary
trackgo summary

# Specific month summary (Format: YYYY-MM)
trackgo summary --month 2026-11

5. Export Data

Export your records to a CSV file for external analysis.

trackgo export --output my_expenses.csv

🧪 Development & Testing

Track Go Plus is built with testing in mind. To run the test suite locally:

# Run all tests
pytest -q

# Run tests with coverage report
pytest --cov=trackgo_plus

🗺️ Roadmap

This project is actively evolving! Here is what's coming next:

  • Budget Limits: Set monthly caps for specific categories.
  • Recurring Expenses: Automate monthly bills (Rent, Netflix, Internet).
  • Rich Terminal UI: Add colored outputs and charts using the rich library.
  • Multi-Currency Support: Track expenses across different currencies.
  • Web Dashboard: A lightweight FastAPI + HTMX web interface for local viewing.

Want a feature? Open an Issue or submit a Pull Request!


🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(This project is optimized for daily open-source contributions. Check out the good first issue tags!)


📄 License

Distributed under the MIT License. See LICENSE for more information.


📫 Contact

khdcoder
GitHub: @khdcoder
Project Link: https://github.com/khdcoder/Track-Go-Plus


About

Track Go Plus is a local-first personal expense tracker CLI. It helps users track daily expenses such as food, travel, rent, and bills.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages