👩🚀 The tiny all-in-one development tool for modern web apps — a versatile utility toolkit for running, checking, converting, analyzing, and managing web module tasks from your terminal.
Commands
All commands accept optional <input> arguments. Without arguments, they display recent entries from their log.
Command
Description
INLINECODE1
Run a web module task and log the result
INLINECODE2
Check a module, dependency, or configuration |
| web-module-runner convert <input> | Convert between module formats or configurations |
| web-module-runner analyze <input> | Analyze a module, bundle, or dependency tree |
| web-module-runner generate <input> | Generate boilerplate, configs, or module scaffolds |
| web-module-runner preview <input> | Preview output or rendered results |
| web-module-runner batch <input> | Batch process multiple items at once |
| web-module-runner compare <input> | Compare two modules, builds, or configurations |
| web-module-runner export <input> | Log an export operation |
| web-module-runner config <input> | Log or update configuration entries |
| web-module-runner status <input> | Log status check results |
| web-module-runner report <input> | Generate or log a report entry |
| web-module-runner stats | Show summary statistics across all log files |
| web-module-runner export json\|csv\|txt | Export all data in JSON, CSV, or plain text format |
| web-module-runner search <term> | Search across all log entries for a keyword |
| web-module-runner recent | Show the 20 most recent activity entries |
| web-module-runner help | Show all available commands |
| web-module-runner version | Print version (v2.0.0) |
Data Storage
All data is stored locally in ~/.local/share/web-module-runner/. Each command maintains its own .log file with timestamped entries in YYYY-MM-DD HH:MM|value format. A unified history.log tracks all operations across commands.
Export formats supported:
- JSON — Array of objects with type, time, and value fields
CSV — Standard comma-separated with type,time,value header
TXT — Human-readable grouped by command type
Requirements
- Bash 4.0+ with set -euo pipefail (strict mode)
Standard Unix utilities: date, wc, du, grep, tail, sed, INLINECODE34
No external dependencies — runs on any POSIX-compliant system
When to Use
1. Tracking web module build tasks — Log and review module runs, builds, and conversions over time
Comparing module configurations — Use compare and analyze to record side-by-side evaluations
Batch processing workflows — Record batch operations and review history for repeatability
Generating reports from logged data — Export accumulated logs to JSON/CSV for downstream analysis
Quick health checks — Use status and stats to verify the toolkit state and entry counts at a glance
Examples
CODEBLOCK0
How It Works
Web Module Runner stores all data locally in ~/.local/share/web-module-runner/. Each command creates a dedicated log file (e.g., run.log, check.log, analyze.log). Every entry is timestamped and appended, providing a full audit trail of all operations. The history.log file aggregates activity across all commands for unified tracking.
When called without arguments, each command displays its most recent 20 entries, making it easy to review past work without needing to manually inspect log files.
Output
All output goes to stdout. Redirect to a file with:
CODEBLOCK1
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
web-module-runner run build main.js --target es2020
分析依赖项
web-module-runner analyze preact@10.x bundle size
批量处理多个模块
web-module-runner batch convert all legacy modules to ESM
搜索包含关键词的先前条目
web-module-runner search preact
将所有内容导出为JSON格式,供外部工具使用
web-module-runner export json
查看汇总统计信息
web-module-runner stats
显示最近的活动日志
web-module-runner recent
工作原理
Web Module Runner将所有数据本地存储在~/.local/share/web-module-runner/中。每个命令创建一个专用的日志文件(例如run.log、check.log、analyze.log)。每个条目都带有时间戳并追加到文件中,提供所有操作的完整审计跟踪。history.log文件汇总所有命令的活动,实现统一跟踪。