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 <input>`	Log a run entry (no args = view recent runs)
`calctool check <input>`	Log a check entry (no args = view recent checks)
`calctool convert <input>`	Log a convert entry (no args = view recent converts)
`calctool analyze <input>`	Log an analyze entry (no args = view recent analyses)
`calctool generate <input>`	Log a generate entry (no args = view recent generates)
`calctool preview <input>`	Log a preview entry (no args = view recent previews)
`calctool batch <input>`	Log a batch entry (no args = view recent batches)
`calctool compare <input>`	Log a compare entry (no args = view recent compares)
`calctool export <input>`	Log an export entry (no args = view recent exports)
`calctool config <input>`	Log a config entry (no args = view recent configs)
`calctool status <input>`	Log a status entry (no args = view recent statuses)
`calctool report <input>`	Log a report entry (no args = view recent reports)
`calctool stats`	Summary statistics — entry counts per category, total, data size
`calctool search <term>`	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 <fmt> 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|<value>

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

Logging calculation results — Record computations, conversions, or analysis results with run, convert, or analyze for future reference
Batch processing and comparison — Log batch operations with batch and side-by-side comparisons with compare
Generating and previewing outputs — Use generate to log generated results and preview to log draft outputs before finalizing
Configuration and status tracking — Record configuration changes with config and system states with status for audit trails
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.