bytesagain 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
| Command | Description |
|---|---|
run <input> |
Record and execute a run entry |
check <input> |
Record a check / verification entry |
convert <input> |
Record a conversion task |
analyze <input> |
Record an analysis entry |
generate <input> |
Record a generation task |
preview <input> |
Record a preview action |
batch <input> |
Record a batch processing task |
compare <input> |
Record a comparison entry |
export <input> |
Record an export operation |
config <input> |
Record a configuration change |
status <input> |
Record a status update |
report <input> |
Record a report entry |
Utility Commands
| Command | Description |
|---|---|
stats |
Show summary statistics across all log files (entry counts, disk usage) |
export <fmt> |
Export all data to a file — supported formats: json, csv, txt |
search <term> |
Search across all log files for a keyword (case-insensitive) |
recent |
Show the 20 most recent entries from the activity history |
status |
Health check — version, data directory, total entries, disk usage, last activity |
help |
Display the full help message with all available commands |
version |
Print the current version (omni-tool v2.0.0) |
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>.logfile - History: Every action is also appended to
history.logwith 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
- Quick task logging — capture run results, check outcomes, or conversion records from the terminal without opening a separate app
- Batch processing workflows — use
omni-tool batchto log batch job details, thenomni-tool statsto review totals - Data analysis pipelines — record analysis steps with
omni-tool analyze, thenomni-tool export jsonfor downstream processing - Configuration auditing — track config changes with
omni-tool configand search history withomni-tool search - Cross-entry reporting — combine
omni-tool reportwithomni-tool statsandomni-tool export csvto 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