A lightning-fast, local-first personal expense tracker for your terminal.
100% Privacy. No Cloud. Just pure tracking.
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.
- ⚡ 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
pytestcoverage to ensure reliability.
- Python 3.10 or higher
- Git
-
Clone the repository:
git clone https://github.com/khdcoder/Track-Go-Plus.git cd Track-Go-Plus -
Set up a virtual environment:
python -m venv .venv # On Windows (PowerShell) .venv\Scripts\Activate.ps1 # On macOS/Linux source .venv/bin/activate
-
Install the package:
pip install -e ".[dev]"
Once installed, you can use the trackgo command from anywhere in your terminal.
Set up your local SQLite database before your first use.
trackgo initLog 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-01View your recent transactions.
trackgo list
trackgo list --category travel --limit 10Get a breakdown of your spending by category.
# All time summary
trackgo summary
# Specific month summary (Format: YYYY-MM)
trackgo summary --month 2026-11Export your records to a CSV file for external analysis.
trackgo export --output my_expenses.csvTrack 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_plusThis 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
richlibrary. - 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!
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
(This project is optimized for daily open-source contributions. Check out the good first issue tags!)
Distributed under the MIT License. See LICENSE for more information.
khdcoder
GitHub: @khdcoder
Project Link: https://github.com/khdcoder/Track-Go-Plus