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 <command> [args] to use.
| Command |
Description |
run <input> |
Record a run entry. Without args, shows the 20 most recent run entries. |
check <input> |
Record a check entry. Without args, shows recent check entries. |
convert <input> |
Record a conversion entry. Without args, shows recent convert entries. |
analyze <input> |
Record an analysis entry. Without args, shows recent analyze entries. |
generate <input> |
Record a generation entry. Without args, shows recent generate entries. |
preview <input> |
Record a preview entry. Without args, shows recent preview entries. |
batch <input> |
Record a batch processing entry. Without args, shows recent batch entries. |
compare <input> |
Record a comparison entry. Without args, shows recent compare entries. |
export <input> |
Record an export entry. Without args, shows recent export entries. |
config <input> |
Record a configuration entry. Without args, shows recent config entries. |
status <input> |
Record a status entry. Without args, shows recent status entries. |
report <input> |
Record a report entry. Without args, shows recent report entries. |
stats |
Show summary statistics across all entry types (counts, data size). |
search <term> |
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|<value> 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---2name: mac-cli3description: macOS command line tool for developers – The ultimate tool to manage your Mac. It provides a huge mac cli, shell, bash, cli, command-line-tool, linux.4---5
6# macOS Toolkit
7
8Macos 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.
9
10## Commands
11
12Run `scripts/script.sh <command> [args]` to use.
13
14| Command | Description |
15|---------|-------------|
16| `run <input>` | Record a run entry. Without args, shows the 20 most recent run entries. |
17| `check <input>` | Record a check entry. Without args, shows recent check entries. |
18| `convert <input>` | Record a conversion entry. Without args, shows recent convert entries. |
19| `analyze <input>` | Record an analysis entry. Without args, shows recent analyze entries. |
20| `generate <input>` | Record a generation entry. Without args, shows recent generate entries. |
21| `preview <input>` | Record a preview entry. Without args, shows recent preview entries. |
22| `batch <input>` | Record a batch processing entry. Without args, shows recent batch entries. |
23| `compare <input>` | Record a comparison entry. Without args, shows recent compare entries. |
24| `export <input>` | Record an export entry. Without args, shows recent export entries. |
25| `config <input>` | Record a configuration entry. Without args, shows recent config entries. |
26| `status <input>` | Record a status entry. Without args, shows recent status entries. |
27| `report <input>` | Record a report entry. Without args, shows recent report entries. |
28| `stats` | Show summary statistics across all entry types (counts, data size). |
29| `search <term>` | Search all log files for a term (case-insensitive). |
30| `recent` | Show the 20 most recent entries from the activity history. |
31| `help` | Show help message with all available commands. |
32| `version` | Show version string (`macos-toolkit v2.0.0`). |
33
34## Data Storage
35
36All data is stored in `~/.local/share/macos-toolkit/`:
37
38- Each command type writes to its own `.log` file (e.g., `run.log`, `check.log`, `convert.log`)
39- Entries are timestamped in `YYYY-MM-DD HH:MM|<value>` format
40- A unified `history.log` tracks all actions across command types
41- Export files are written to the same directory as `export.json`, `export.csv`, or `export.txt`
42
43## Requirements
44
45- Bash 4+ with `set -euo pipefail`
46- Standard Unix utilities (`date`, `wc`, `du`, `tail`, `grep`, `sed`, `cat`)
47- No external dependencies — works out of the box on Linux and macOS
48
49## When to Use
50
511. **System checks and diagnostics** — use `check` and `analyze` to record system health checks, diagnostic results, and analysis findings on your Mac
522. **File conversion tracking** — log `convert` operations when batch-converting file formats, encoding, or data transformations
533. **Configuration management** — use `config` to track system configuration changes and `status` to record current system states for auditing
544. **Batch processing workflows** — record `batch` and `generate` entries to document automated processing pipelines and their outputs
555. **Reporting and export** — use `report` to log generated reports and export accumulated data to JSON, CSV, or TXT for sharing or archival
56
57## Examples
58
59```bash
60# Record a system check
61macos-toolkit check "Homebrew packages up to date, 142 installed"
62
63# Log a file conversion operation
64macos-toolkit convert "Converted 50 HEIC photos to JPEG format"
65
66# Analyze disk usage
67macos-toolkit analyze "SSD: 234GB used / 500GB total, 47% capacity"
68
69# Record a batch operation
70macos-toolkit batch "Resized 200 images to 1080p for web deployment"
71
72# Search across all entries
73macos-toolkit search "disk"
74
75# Export all data as JSON
76macos-toolkit export json
77
78# View summary statistics
79macos-toolkit stats
80```
81
82## Output
83
84All 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:
85
86```bash
87macos-toolkit stats > report.txt
88```
89
90## Configuration
91
92Set the `DATA_DIR` inside the script or modify the default path `~/.local/share/macos-toolkit/` to change where data is stored.
93
94---
95Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
bytesagain