MCPcopy Index your code
hub / github.com/ayanchavand/FiTui

github.com/ayanchavand/FiTui @v0.3.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.3.0 ↗ · + Follow
158 symbols 392 edges 15 files 20 documented · 13%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

FiTui

Built With Ratatui Crates.io Version Crates.io Downloads (latest version)

A lightweight terminal-based personal finance tracker. Record transactions, track spending, and view financial insights from your terminal.

Version: 0.3.0


Features

  • Transaction management: add, edit, and delete credit/debit entries
  • Stats view with totals and spending breakdowns by tag
  • Recurring transactions for bills, salary, and subscriptions
  • Local SQLite storage with configurable tags and currency
  • Keyboard-driven interface

Screenshots

Main Interface

Main interface

Stats View

Stats view


Installation

Via Cargo

cargo install fitui

Build from Source

Requires Rust.

cargo build --release

Binary: target/release/fitui (Windows: fitui.exe)

Linux / macOS

mkdir -p ~/.local/bin
cp target/release/fitui ~/.local/bin/
chmod +x ~/.local/bin/fitui
fitui

Ensure ~/.local/bin is in your $PATH:

export PATH="$HOME/.local/bin:$PATH"

Windows

  1. Copy fitui.exe to a permanent location (e.g. C:\Users\<you>\bin\)
  2. Add that folder to your PATH via System Properties
  3. Run fitui from any terminal

Termux (Android)

pkg install rust
cargo build --release
cp target/release/fitui ~/.local/bin/
fitui

Note: first build may take 10-15 minutes on mobile.


Configuration

Config is created automatically on first run.

OS Database Config
Linux ~/.local/share/fitui/budget.db ~/.config/fitui/config.yaml
macOS ~/Library/Application Support/com.ayan.fitui/budget.db ~/Library/Preferences/com.ayan.fitui/config.yaml
Windows AppData\Roaming\ayan\fitui\data\budget.db AppData\Roaming\ayan\fitui\config\config.yaml

config.yaml

currency: "$"  # $, EUR, GBP, JPY, INR, etc.

tags:
  - food
  - travel
  - shopping
  - bills
  - salary
  - other

Planned

  • CSV import from bank statements and payment apps
  • Budget limits per tag
  • Search and filter by amount, date, or tag
  • Export to CSV/PDF
  • Custom date range stats
  • Multi-currency support
  • Transaction notes
  • Data backup and sync

Feature request or bug? Open an issue.


Changelog

[0.3.0] - 2026-02-27

Added - Tab-based navigation across views - Active tab indicator - Transaction date grouping - Ratio-based column constraints for consistent table layout - Improved empty state messaging

Changed - Transactions list refactored to table layout - UI formatting and spacing improvements - Cleaner tab rendering

Fixed - Quit now works regardless of current mode


License

MIT

Core symbols most depended-on inside this repo

block
called by 19
src/theme.rs
as_str
called by 18
src/models.rs
get_transactions
called by 17
src/db.rs
insert_recurring_transactions
called by 12
src/db.rs
muted_text
called by 11
src/theme.rs
get_recurring_entries
called by 7
src/db.rs
add_recurring_entry
called by 6
src/db.rs
set_tab
called by 5
src/app.rs

Shape

Function 95
Method 49
Class 8
Enum 6

Languages

Rust100%

Modules by API surface

src/app.rs22 symbols
src/stats.rs21 symbols
src/db.rs20 symbols
src/ui.rs19 symbols
src/theme.rs18 symbols
src/form.rs18 symbols
src/models.rs10 symbols
src/ui/form.rs8 symbols
src/ui/header.rs5 symbols
src/handlers.rs5 symbols
src/config.rs5 symbols
tests/db_integration.rs4 symbols

For agents

$ claude mcp add FiTui \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page