Omni

---

name: Omni

description: "Boost productivity with an all-in-one terminal toolkit for tasks and automation. Use when running utilities, automating tasks, streamlining workflows."

version: "1.0.0"

license: MIT

runtime: python3

---

# Omni

All-in-one terminal utility toolkit for running, checking, converting, analyzing, generating, and managing tasks from the command line. Omni 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 <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 v2.0.0`) |

Data Storage

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

Requirements

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 batch` to log batch job details, then `omni stats` to review totals

3. **Data analysis pipelines** — record analysis steps with `omni analyze`, then `omni export json` for downstream processing

4. **Configuration auditing** — track config changes with `omni config` and search history with `omni search`

5. **Cross-entry reporting** — combine `omni report` with `omni stats` and `omni export csv` to produce summary reports across all command categories

Examples

Record a run and view recent entries

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

# View recent run entries
omni run

Analyze, then export results

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

# Export everything to JSON
omni export json

Search and report

# Search across all logs
omni search "staging"

# Check overall statistics
omni stats

# View recent activity
omni recent

Batch processing workflow

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

# Review and export
omni stats
omni export csv

Health check and comparison

# System health overview
omni status

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

# View comparison history
omni compare

Output

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

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

---

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