Github url

m-cli

by rgcr

rgcr /m-cli

 Swiss Army Knife for macOS

8.1K Stars 287 Forks Last release: Not found MIT License 288 Commits 25 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

 m-cli

:boom: Swiss Army Knife for macOS !

OverviewInstallUninstallHow To UseAll CommandsContributing

Overview

m-cli is a macOS command line tool that lets you interact with utilities and applications entirely in Terminal. It differs from other macOS command line tools in the following ways:

  • You can easily manage administrative tasks
  • It doesn't install 3rd party tools since it doesn't have dependencies
  • Installation is easy and doesn't require intervention
  • It only uses macOS commands

Install

You can install m-cli using Homebrew, or you can manually install it.

Homebrew install

If you have Homebrew installed, run:

brew install m-cli

Manual install

If you want to manually install m-cli, run:

curl -fsSL https://raw.githubusercontent.com/rgcr/m-cli/master/install.sh | sudo sh

You can also install it to a different path, shown below:

INSTALL\_DIR=$HOME/.m-cli sh 

_Note: You need privileges_

# Uninstall

To uninstall **m-cli** from your system, run:

m --uninstall


# How To Use

**m-cli** commands are executed using the following steps:

#### 1. Run 

m

to display all of the commands (utilities) available in **m-cli**.

#### 2. Run 

m

 to display the options available for this command.

#### 3. Run 

m

 to execute an option for this command.

A diagram of this structure is shown below:

m |___itunes | |___status | |___play | |___pause | | | ... | |___disk |___ls |___list |___fs ...


For example, running

m itunes

 will display the options available for iTunes, as shown below:

usage: m itunes [status | play | pause | next | prev | mute | unmute | vol up | vol down | vol #| stop | quit | help] Examples: m itunes status # Show status m itunes play # Play track m itunes pause # Pause track m itunes next # Play next track m itunes prev # Play previous track m itunes mute # Mute iTunes m itunes unmute # Unmute iTunes m itunes vol up # Volume Up m itunes vol down # Volume Down m itunes vol # # Set volume level m itunes stop # Stop track m itunes quit # Quit iTunes


In this example, running

m itunes play

 will play the current selected track in your iTunes music library. 
# All Commands

**m-cli** currently supports the following commands:

help

battery

bluetooth

dir

disk

display

dns

dock

finder

firewall

flightmode

gatekeeper

hostname

info

itunes

localhost

lock

ntp

printer

network

nosleep

notification

restart

safeboot

screensaver

service

shutdown

sleep

timezone

touchbar

trash

update

user

volume

vpn

wallpaper

wifi


# Contributing

1. Fork it!
2. Create your feature branch: 

git checkout -b my-new-feature

3. Commit your changes: 

git commit -m 'Add some feature'

4. Push to the branch: 

git push origin my-new-feature

5. Submit a pull request :metal:

# TODO:
  • Add more plugins
  • Improve the help
  • Improve the installation script

Thanks

guarinogabriel/Mac-CLI was a great source of inspiration.


MIT License © Rogelio Cedillo

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.