概述

macOS Toolkit

Macos Toolkit v2.0.0 — a utility toolkit for managing, analyzing, converting, and processing data from the command line. Supports run, check, convert, analyze, generate, preview, batch, compare, export, config, status, and report operations — all tracked with timestamped entries stored locally.

Commands

Run scripts/script.sh [args] to use.

Command	Description
---------	-------------
`run`	Record a run entry. Without args, shows the 20 most recent run entries.
`check`	Record a check entry. Without args, shows recent check entries.
`convert`	Record a conversion entry. Without args, shows recent convert entries.
`analyze`	Record an analysis entry. Without args, shows recent analyze entries.
`generate`	Record a generation entry. Without args, shows recent generate entries.
`preview`	Record a preview entry. Without args, shows recent preview entries.
`batch`	Record a batch processing entry. Without args, shows recent batch entries.
`compare`	Record a comparison entry. Without args, shows recent compare entries.
`export`	Record an export entry. Without args, shows recent export entries.
`config`	Record a configuration entry. Without args, shows recent config entries.
`status`	Record a status entry. Without args, shows recent status entries.
`report`	Record a report entry. Without args, shows recent report entries.
`stats`	Show summary statistics across all entry types (counts, data size).
`search`	Search all log files for a term (case-insensitive).
`recent`	Show the 20 most recent entries from the activity history.
`help`	Show help message with all available commands.
`version`	Show version string (`macos-toolkit v2.0.0`).

Data Storage

All data is stored in ~/.local/share/macos-toolkit/:

Each command type writes to its own .log file (e.g., run.log, check.log, convert.log)
Entries are timestamped in YYYY-MM-DD HH:MM| format
A unified history.log tracks all actions across command types
Export files are written to the same directory as export.json, export.csv, or export.txt

Requirements

Bash 4+ with set -euo pipefail
Standard Unix utilities (date, wc, du, tail, grep, sed, cat)
No external dependencies — works out of the box on Linux and macOS

When to Use

System checks and diagnostics — use check and analyze to record system health checks, diagnostic results, and analysis findings on your Mac
File conversion tracking — log convert operations when batch-converting file formats, encoding, or data transformations
Configuration management — use config to track system configuration changes and status to record current system states for auditing
Batch processing workflows — record batch and generate entries to document automated processing pipelines and their outputs
Reporting and export — use report to log generated reports and export accumulated data to JSON, CSV, or TXT for sharing or archival

Examples

# Record a system check
macos-toolkit check "Homebrew packages up to date, 142 installed"

# Log a file conversion operation
macos-toolkit convert "Converted 50 HEIC photos to JPEG format"

# Analyze disk usage
macos-toolkit analyze "SSD: 234GB used / 500GB total, 47% capacity"

# Record a batch operation
macos-toolkit batch "Resized 200 images to 1080p for web deployment"

# Search across all entries
macos-toolkit search "disk"

# Export all data as JSON
macos-toolkit export json

# View summary statistics
macos-toolkit stats

Output

All commands print results to stdout. Each recording command confirms the save and shows the total entry count for that category. Redirect output to a file with:

macos-toolkit stats > report.txt

Configuration

Set the DATA_DIR inside the script or modify the default path ~/.local/share/macos-toolkit/ to change where data is stored.

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

版本历史

共 1 个版本

v1.0.0 当前

2026-03-30 19:49 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)