$ show rgcr/m-cli
m-cli is a macOS command-line utility that provides a unified interface for managing system settings, preferences, and services. It consists of a main dispatcher script (`m`) and over 40 plugin scripts, each handling a specific macOS subsystem (e.g., Wi-Fi, Bluetooth, display, dock, permissions). The architecture is a simple plugin-based monolith: the main script resolves the plugin path and delegates execution. Plugins follow a consistent pattern with `--help` output that is parsed by shell completion scripts to dynamically generate completions for bash, zsh, and fish. The codebase is entirely written in Bash (with one Python plugin for screen lock) and relies on macOS native commands (`defaults`, `osascript`, `systemsetup`, `diskutil`, etc.). It is well-structured, with clear separation of concerns, standardized option parsing, and a small test suite using Bats. While the plugins are tightly coupled to macOS, the overall architecture and the dynamic completion generation pattern are reusable concepts.
The LLM identified 3 files worth highlighting for reuse:
The `tree_dirs` function in this plugin implements a recursive directory tree printer using pure Bash. It traverses directories, sorts entries, and prints a tree with Unicode connectors (├──, └──, │). It is self-contained, has no external dependencies, and can be extracted into a standalone script for any project needing a lightweight tree view.
This Bash completion script dynamically generates completions by parsing the `--help` output of each plugin. It extracts option names and possible values (from `<val1|val2>` syntax) and provides context-aware completions. The pattern of generating completions from help text is reusable for any CLI tool with a consistent help format, eliminating manual completion maintenance.
A self-contained Bash script that clones or updates a Git repository and creates a symlink. It handles idempotent updates, error checking, and provides a clean uninstall path. This pattern can be reused as a generic installer for any CLI tool distributed via Git.