S
SkillNav

Arbitrage Finder

by BytesAgain

Scan cross-exchange price gaps and score arbitrage profitability. Use when comparing crypto prices, tracking spreads, or evaluating trades.

View Chinese version with editor review

安装

claude skill add --url github.com/openclaw/skills/tree/main/skills/bytesagain1/arbitrage-finder

文档

Arbitrage Finder

A financial tracking and analysis tool for recording transactions, monitoring budgets, comparing spending periods, and generating simple forecasts. Provides a CLI interface for personal finance management with persistent local storage.

Commands

CommandDescription
trackRecord a transaction with description and amount
balanceShow current balance from the ledger
summaryDisplay financial summary for the current period
exportExport transaction data to CSV format
budgetShow budget overview by category with remaining
historyView recent transaction history (last 20 entries)
alertSet a price or budget alert with threshold
compareCompare spending between current and previous period
forecastGenerate a simple financial forecast based on trends
categoriesList all spending categories
helpShow the help message with all available commands
versionPrint the current version number

Data Storage

  • Data directory: ~/.local/share/arbitrage-finder/ (override with ARBITRAGE_FINDER_DIR env variable)
  • Data log: $DATA_DIR/data.log — stores transaction records
  • History log: $DATA_DIR/history.log — tracks all command executions with timestamps
  • Ledger: $DATA_DIR/ledger — balance tracking file

Requirements

  • Bash 4.0+
  • Standard Unix utilities (grep, cat, date, tail)
  • No API keys or external services needed
  • Works on Linux and macOS

When to Use

  1. Transaction tracking — When you need to log income and expenses with timestamps and descriptions
  2. Budget monitoring — When you want to see how much you've spent vs. budgeted across categories like Food, Transport, Housing, Entertainment, and Savings
  3. Period comparison — When you need to compare your spending habits between the current and previous period to spot trends
  4. Data export — When you need to export your financial records to CSV format for use in spreadsheets or other tools
  5. Financial forecasting — When you want a quick projection based on historical spending trends

Examples

bash
# Record a transaction
arbitrage-finder track "Grocery shopping" 85.50

# Check current balance
arbitrage-finder balance

# View financial summary for the current month
arbitrage-finder summary

# View recent transaction history
arbitrage-finder history

# Set an alert for a budget threshold
arbitrage-finder alert "Food" 500

# Compare current vs previous period spending
arbitrage-finder compare

# List all spending categories
arbitrage-finder categories

# Export transactions to CSV
arbitrage-finder export > transactions.csv

# Generate a simple forecast
arbitrage-finder forecast

Output

All command results are printed to stdout. You can redirect output with standard shell operators:

bash
arbitrage-finder export > financial-data.csv
arbitrage-finder history | grep "Grocery"

Configuration

Set the ARBITRAGE_FINDER_DIR environment variable to change the data directory:

bash
export ARBITRAGE_FINDER_DIR="/custom/path/to/arbitrage-finder"

Default location: ~/.local/share/arbitrage-finder/

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com