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

Calctool

by @ckchzh

Perform basic, scientific, and financial calculations from the terminal. Use when computing interest, converting units, or solving quick math.

Versionv2.0.1
Downloads574
Installs1
#clawhub
TERMINAL
clawhub install calctool

πŸ“– About This Skill

name: CalcTool description: "Perform basic, scientific, and financial calculations from the terminal. Use when computing interest, converting units, or solving quick math." version: "2.0.0" author: "BytesAgain" homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills tags: ["calculator","math","arithmetic","scientific","convert","finance","utility"] categories: ["Utility", "Productivity"]

CalcTool

Utility toolkit β€” run, check, convert, analyze, generate, preview, batch, compare, and manage data entries. Each command logs input with timestamps for full traceability and review.

Commands

| Command | Description | |---------|-------------| | calctool run | Log a run entry (no args = view recent runs) | | calctool check | Log a check entry (no args = view recent checks) | | calctool convert | Log a convert entry (no args = view recent converts) | | calctool analyze | Log an analyze entry (no args = view recent analyses) | | calctool generate | Log a generate entry (no args = view recent generates) | | calctool preview | Log a preview entry (no args = view recent previews) | | calctool batch | Log a batch entry (no args = view recent batches) | | calctool compare | Log a compare entry (no args = view recent compares) | | calctool export | Log an export entry (no args = view recent exports) | | calctool config | Log a config entry (no args = view recent configs) | | calctool status | Log a status entry (no args = view recent statuses) | | calctool report | Log a report entry (no args = view recent reports) | | calctool stats | Summary statistics β€” entry counts per category, total, data size | | calctool search | Search across all log entries | | calctool recent | Show last 20 history entries | | calctool help | Show usage info | | calctool version | Show version string |

> Note: The export and status commands in the case dispatch also have utility variants (_export and _status) that provide structured export (json/csv/txt) and health check output respectively. However, the primary case match routes to the logging version.

Data Storage

All data is stored locally in ~/.local/share/calctool/. Each command writes to its own .log file (e.g., run.log, check.log, analyze.log). A unified history.log records every action with timestamps. No external services or databases required.

Log format: YYYY-MM-DD HH:MM|

Export formats: JSON, CSV, or plain text (via the _export helper function).

Requirements

  • bash (version 4+ recommended)
  • Standard POSIX utilities: date, wc, du, grep, tail, head, cat
  • No external dependencies, no network access needed
  • Works on Linux, macOS, and WSL

    • When to Use

    1. Logging calculation results β€” Record computations, conversions, or analysis results with run, convert, or analyze for future reference 2. Batch processing and comparison β€” Log batch operations with batch and side-by-side comparisons with compare 3. Generating and previewing outputs β€” Use generate to log generated results and preview to log draft outputs before finalizing 4. Configuration and status tracking β€” Record configuration changes with config and system states with status for audit trails 5. Reporting and data export β€” Create report entries for periodic summaries and use stats or search to review all logged data

    Examples

    # Log a calculation run
calctool run "2 * (3 + 4) / 5 = 2.8"
    Log a unit conversion
    
calctool convert "100 USD to CNY = 725.30"
    Log an analysis result
    
calctool analyze "Dataset A: mean=45.2, std=12.1, n=500"
    Compare two results
    
calctool compare "Plan A: $12,000/yr vs Plan B: $10,800/yr β€” B saves 10%"
    Generate a report entry
    
calctool report "Q1 2026 summary: 142 entries, 98% accuracy"
    Search for specific entries
    
calctool search "USD"
    View summary statistics
    
calctool stats
    View recent activity
    
calctool recent
    Check health status
    
calctool status

    How It Works

    CalcTool stores all data locally in ~/.local/share/calctool/. Each command logs activity with timestamps for full traceability. Use stats to see a summary of entries per category with total counts and data size. Use search to find specific entries across all logs, recent to view the latest activity, or the built-in export helper to back up your data in JSON, CSV, or plain text format.

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

    ⚑ When to Use

    TriggerAction
    2. **Batch processing and comparison** β€” Log batch operations with `batch` and side-by-side comparisons with `compare`
    3. **Generating and previewing outputs** β€” Use `generate` to log generated results and `preview` to log draft outputs before finalizing
    4. **Configuration and status tracking** β€” Record configuration changes with `config` and system states with `status` for audit trails
    5. **Reporting and data export** β€” Create `report` entries for periodic summaries and use `stats` or `search` to review all logged data

    πŸ’‘ Examples

    # Log a calculation run
calctool run "2 * (3 + 4) / 5 = 2.8"
    Log a unit conversion
    
calctool convert "100 USD to CNY = 725.30"
    Log an analysis result
    
calctool analyze "Dataset A: mean=45.2, std=12.1, n=500"
    Compare two results
    
calctool compare "Plan A: $12,000/yr vs Plan B: $10,800/yr β€” B saves 10%"
    Generate a report entry
    
calctool report "Q1 2026 summary: 142 entries, 98% accuracy"
    Search for specific entries
    
calctool search "USD"
    View summary statistics
    
calctool stats
    View recent activity
    
calctool recent
    Check health status
    
calctool status