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: INLINECODE0
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 |
|---|
| INLINECODE1 | Record and execute a run entry |
| INLINECODE2 |
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 |
|---|
| INLINECODE13 | Show summary statistics across all log files (entry counts, disk usage) |
| INLINECODE14 |
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: INLINECODE24
- 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, INLINECODE36 - 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
- Batch processing workflows — use
omni-tool batch to log batch job details, then omni-tool stats to review totals - Data analysis pipelines — record analysis steps with
omni-tool analyze, then omni-tool export json for downstream processing - Configuration auditing — track config changes with
omni-tool config and search history with INLINECODE42 - 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
CODEBLOCK0
Analyze, then export results
CODEBLOCK1
Search and report
CODEBLOCK2
Batch processing workflow
CODEBLOCK3
Health check and comparison
CODEBLOCK4
Output
All commands output to stdout. Redirect to a file with:
CODEBLOCK5
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
Omni 工具
一体化终端实用工具包,用于从命令行运行、检查、转换、分析、生成和管理任务。Omni 工具提供 12 个核心操作命令,以及内置的统计、数据导出、搜索和健康检查功能——全部基于本地日志存储。
命令
所有命令遵循以下模式:omni-tool <命令> [输入]
当不带参数调用时,每个命令显示其最近的 20 条日志条目。
当带参数调用时,它会记录带有时间戳的输入。
核心操作命令
| 命令 | 描述 |
|---|
| run <输入> | 记录并执行一个运行条目 |
| check <输入> |
记录一个检查/验证条目 |
| convert <输入> | 记录一个转换任务 |
| analyze <输入> | 记录一个分析条目 |
| generate <输入> | 记录一个生成任务 |
| preview <输入> | 记录一个预览操作 |
| batch <输入> | 记录一个批处理任务 |
| compare <输入> | 记录一个比较条目 |
| export <输入> | 记录一个导出操作 |
| config <输入> | 记录一个配置变更 |
| status <输入> | 记录一个状态更新 |
| report <输入> | 记录一个报告条目 |
实用命令
| 命令 | 描述 |
|---|
| stats | 显示所有日志文件的汇总统计信息(条目数、磁盘使用量) |
| export <格式> |
将所有数据导出到文件——支持的格式:json、csv、txt |
| search <关键词> | 在所有日志文件中搜索关键词(不区分大小写) |
| recent | 显示活动历史中最近的 20 条条目 |
| status | 健康检查——版本、数据目录、总条目数、磁盘使用量、最近活动 |
| help | 显示包含所有可用命令的完整帮助信息 |
| version | 打印当前版本(omni-tool v2.0.0) |
数据存储
所有数据本地存储在纯文本日志文件中:
- - 位置: ~/.local/share/omni-tool/
- 格式: 每个条目为 YYYY-MM-DD HH:MM|<输入> 格式的一行,存储在对应的 <命令>.log 文件中
- 历史记录: 每个操作也会附加到 history.log 中,带有时间戳和命令标签
- 导出格式: JSON(对象数组)、CSV(带表头)、纯文本(按命令分组)
- 无外部依赖——纯 bash,随处可运行
要求
- - Bash 4.0+(使用 set -euo pipefail)
- 核心工具: date、wc、du、tail、grep、sed、cat、basename
- 无需网络访问——完全离线
- 无需配置——开箱即用
使用场景
- 1. 快速任务记录——从终端捕获运行结果、检查结果或转换记录,无需打开单独的应用
- 批处理工作流——使用 omni-tool batch 记录批处理作业详情,然后使用 omni-tool stats 查看总数
- 数据分析管道——使用 omni-tool analyze 记录分析步骤,然后使用 omni-tool export json 进行下游处理
- 配置审计——使用 omni-tool config 跟踪配置变更,使用 omni-tool search 搜索历史
- 跨条目报告——结合使用 omni-tool report、omni-tool stats 和 omni-tool export csv,生成所有命令类别的汇总报告
示例
记录运行并查看最近条目
bash
记录一个任务
omni-tool run 部署 staging v2.3.1
查看最近的运行条目
omni-tool run
分析,然后导出结果
bash
记录分析条目
omni-tool analyze node-3 上的 CPU 使用率飙升
omni-tool analyze 工作线程池中的内存泄漏
将所有内容导出为 JSON
omni-tool export json
搜索和报告
bash
在所有日志中搜索
omni-tool search staging
查看总体统计信息
omni-tool stats
查看最近活动
omni-tool recent
批处理工作流
bash
记录批处理操作
omni-tool batch 处理图片 batch-042
omni-tool batch 调整缩略图大小 batch-042
查看和导出
omni-tool stats
omni-tool export csv
健康检查和比较
bash
系统健康概览
omni-tool status
记录比较
omni-tool compare prod-v2 与 staging-v2.1 延迟对比
查看比较历史
omni-tool compare
输出
所有命令输出到标准输出。重定向到文件:
bash
omni-tool stats > report.txt
omni-tool export json # 写入 ~/.local/share/omni-tool/export.json
由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com