CashFlow

CashFlow is a multi-purpose utility tool for tracking and managing data entries from the terminal. It provides a simple log-based system for adding, listing, searching, and exporting entries with timestamped records.

Commands

How It Works

CashFlow uses a flat-file approach. All entries are stored in data.log as dated lines (YYYY-MM-DD <content>). Every command also appends a timestamped record to history.log for auditing.

• - add appends a new line with today's date
• INLINECODE17 prints the full data log
• INLINECODE18 performs case-insensitive matching via INLINECODE19
• INLINECODE20 dumps the raw data log to stdout for piping/redirection

Data Storage

All data is stored locally in ~/.local/share/cashflow/ by default:

• - data.log — Main data file with all entries (one per line, date-prefixed)
• INLINECODE23 — Timestamped audit trail of every command executed
• INLINECODE24 — Configuration file (referenced by cashflow config)

Override the storage location by setting the CASHFLOW_DIR environment variable:

CODEBLOCK0

Alternatively, XDG_DATA_HOME is respected if CASHFLOW_DIR is not set.

Requirements

• - bash 4+ (uses set -euo pipefail for strict mode)
• Standard Unix tools (grep, date, cat)
• No API keys needed
• No external dependencies

When to Use

1. 1. Quick data logging — Use cashflow add to rapidly log entries (expenses, tasks, notes) with automatic date stamps
2. Reviewing stored entries — Run cashflow list to see everything you've logged, or cashflow search to find specific entries
3. Exporting data for analysis — Use cashflow export > data.csv to dump all entries for import into spreadsheets or other tools
4. Project initialization — Run cashflow init to set up the data directory on a new machine or project
5. Checking tool status — Use cashflow status and cashflow info to verify the tool is ready and see version/path information

Examples

CODEBLOCK1

CODEBLOCK2

CODEBLOCK3

Output

All command output goes to stdout. The history log is always written to $DATA_DIR/history.log. Redirect output as needed:

CODEBLOCK4

Configuration