Omni Tool

All-in-one terminal utility toolkit for running, checking, converting, analyzing, generating, and managing tasks from the command line. Omni Tool provides 12 core action commands plus built-in statistics, data export, search, and health-check capabilities — all backed by local log-based storage.

Commands

All commands follow the pattern: omni-tool <command> [input]

When called without arguments, each command displays its most recent 20 log entries. When called with arguments, it records the input with a timestamp.

Core Action Commands

Utility Commands

Data Storage

All data is stored locally in plain-text log files:

• Location: ~/.local/share/omni-tool/
• Format: Each entry is a line of YYYY-MM-DD HH:MM|<input> in the corresponding <command>.log file
• History: Every action is also appended to history.log with a timestamp and command label
• Export formats: JSON (array of objects), CSV (with headers), plain text (grouped by command)
• No external dependencies — pure bash, runs anywhere

Requirements

• Bash 4.0+ (uses set -euo pipefail)
• Core utilities: date, wc, du, tail, grep, sed, cat, basename
• No network access required — fully offline
• No configuration needed — works out of the box

When to Use

1. Quick task logging — capture run results, check outcomes, or conversion records from the terminal without opening a separate app
2. Batch processing workflows — use omni-tool batch to log batch job details, then omni-tool stats to review totals
3. Data analysis pipelines — record analysis steps with omni-tool analyze, then omni-tool export json for downstream processing
4. Configuration auditing — track config changes with omni-tool config and search history with omni-tool search
5. Cross-entry reporting — combine omni-tool report with omni-tool stats and omni-tool export csv to produce summary reports across all command categories

Examples

Record a run and view recent entries

# Log a task
omni-tool run "deploy staging v2.3.1"

# View recent run entries
omni-tool run

Analyze, then export results

# Record analysis entries
omni-tool analyze "CPU usage spike on node-3"
omni-tool analyze "Memory leak in worker pool"

# Export everything to JSON
omni-tool export json

Search and report

# Search across all logs
omni-tool search "staging"

# Check overall statistics
omni-tool stats

# View recent activity
omni-tool recent

Batch processing workflow

# Log batch operations
omni-tool batch "process images batch-042"
omni-tool batch "resize thumbnails batch-042"

# Review and export
omni-tool stats
omni-tool export csv

Health check and comparison

# System health overview
omni-tool status

# Record comparisons
omni-tool compare "prod-v2 vs staging-v2.1 latency"

# View comparison history
omni-tool compare

Output

All commands output to stdout. Redirect to a file with:

omni-tool stats > report.txt
omni-tool export json   # writes to ~/.local/share/omni-tool/export.json

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