🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Compound

by @xueyetianya

Calculate compound interest and investment growth using financial formulas. Use when you need to plan savings, compare rates, or project wealth.

Versionv1.0.0
Downloads457
Installs1
TERMINAL
clawhub install compound

πŸ“– About This Skill


name: compound version: "1.0.0" description: "Calculate compound interest and investment growth using financial formulas. Use when you need to plan savings, compare rates, or project wealth." author: BytesAgain homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills tags: [finance, compound-interest, calculator, investment, savings, planning]

Compound β€” Compound Interest Calculator

Compound is a command-line compound interest calculator that helps you plan investments, compare interest rates, build amortization schedules, and project financial growth over time.

All calculation history is stored in ~/.compound/data.jsonl as JSONL records for future reference and comparison.

Prerequisites

  • Python 3.8+ with standard library
  • bash shell
  • Commands

    calculate

    Calculate compound interest for a given principal, rate, and time period.

    Environment Variables:

  • PRINCIPAL (required) β€” Initial investment amount
  • RATE (required) β€” Annual interest rate as percentage (e.g., 5.5)
  • YEARS (required) β€” Number of years
  • FREQUENCY β€” Compounding frequency: daily, monthly, quarterly, annually (default: monthly)
  • CONTRIBUTION β€” Regular contribution amount (default: 0)
  • CONTRIB_FREQ β€” Contribution frequency: monthly, quarterly, annually (default: monthly)
  • Example:

    PRINCIPAL=10000 RATE=7.5 YEARS=20 FREQUENCY=monthly bash scripts/script.sh calculate
    

    compare

    Compare multiple interest rate or compounding frequency scenarios side by side.

    Environment Variables:

  • PRINCIPAL (required) β€” Initial investment amount
  • RATES (required) β€” Comma-separated list of rates to compare (e.g., "3,5,7,10")
  • YEARS (required) β€” Number of years
  • FREQUENCY β€” Compounding frequency (default: monthly)
  • schedule

    Generate a detailed payment/growth schedule showing balances at each period.

    Environment Variables:

  • PRINCIPAL (required) β€” Initial investment amount
  • RATE (required) β€” Annual interest rate as percentage
  • YEARS (required) β€” Number of years
  • FREQUENCY β€” Compounding frequency (default: monthly)
  • CONTRIBUTION β€” Regular contribution amount (default: 0)
  • table

    Display a year-by-year summary table of investment growth.

    Environment Variables:

  • PRINCIPAL (required) β€” Initial investment amount
  • RATE (required) β€” Annual interest rate
  • YEARS (required) β€” Number of years
  • CONTRIBUTION β€” Regular contribution (default: 0)
  • rate

    Calculate the required interest rate to reach a financial goal.

    Environment Variables:

  • PRINCIPAL (required) β€” Starting amount
  • TARGET (required) β€” Target amount
  • YEARS (required) β€” Time period in years
  • FREQUENCY β€” Compounding frequency (default: monthly)
  • goal

    Calculate how long it takes to reach a savings goal.

    Environment Variables:

  • PRINCIPAL (required) β€” Starting amount
  • TARGET (required) β€” Goal amount
  • RATE (required) β€” Annual interest rate
  • CONTRIBUTION β€” Regular contribution (default: 0)
  • chart

    Generate an ASCII chart of investment growth over time.

    Environment Variables:

  • PRINCIPAL (required) β€” Initial amount
  • RATE (required) β€” Annual interest rate
  • YEARS (required) β€” Number of years
  • WIDTH β€” Chart width in characters (default: 60)
  • HEIGHT β€” Chart height in lines (default: 20)
  • export

    Export calculation history to a file.

    Environment Variables:

  • OUTPUT β€” Output file path (default: stdout)
  • FORMAT β€” Export format: json, csv, jsonl (default: json)
  • CALC_ID β€” Specific calculation ID to export (default: all)
  • config

    View or update default configuration settings.

    Environment Variables:

  • KEY β€” Configuration key to set
  • VALUE β€” Configuration value
  • history

    View past calculations with their results.

    Environment Variables:

  • LIMIT β€” Maximum entries to display (default: 20)
  • SORT β€” Sort by: date, principal, rate, total (default: date)
  • help

    Display usage information and available commands.

    version

    Display the current version of the compound tool.

    Data Storage

    All calculations are stored in ~/.compound/data.jsonl. Each line is a JSON object with fields:

  • id β€” Unique calculation identifier
  • timestamp β€” ISO 8601 creation time
  • type β€” Calculation type (calculate, compare, goal, etc.)
  • params β€” Input parameters
  • result β€” Calculation results (final amount, interest earned, etc.)
  • Configuration

    Config stored in ~/.compound/config.json:

  • default_frequency β€” Default compounding frequency (default: monthly)
  • currency_symbol β€” Currency symbol for display (default: $)
  • decimal_places β€” Number of decimal places (default: 2)

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

    βš™οΈ Configuration

    Config stored in ~/.compound/config.json:

  • default_frequency β€” Default compounding frequency (default: monthly)
  • currency_symbol β€” Currency symbol for display (default: $)
  • decimal_places β€” Number of decimal places (default: 2)

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