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
exportandstatuscommands 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, oranalyzefor future reference - Batch processing and comparison — Log batch operations with
batchand side-by-side comparisons withcompare - Generating and previewing outputs — Use
generateto log generated results andpreviewto log draft outputs before finalizing - Configuration and status tracking — Record configuration changes with
configand system states withstatusfor audit trails - Reporting and data export — Create
reportentries for periodic summaries and usestatsorsearchto 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