{"id":27993298,"url":"https://github.com/xwmx/osx-cli","last_synced_at":"2025-05-08T18:49:01.894Z","repository":{"id":26385948,"uuid":"29835414","full_name":"xwmx/osx-cli","owner":"xwmx","description":"A collection of command line shortcuts for common OS X operations.","archived":false,"fork":false,"pushed_at":"2019-10-22T20:49:52.000Z","size":76,"stargazers_count":24,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-02T00:56:12.819Z","etag":null,"topics":["macos","osx","osx-cli","shell"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xwmx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-25T23:02:36.000Z","updated_at":"2023-05-09T03:16:44.000Z","dependencies_parsed_at":"2022-08-28T23:03:56.290Z","dependency_job_id":null,"html_url":"https://github.com/xwmx/osx-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xwmx%2Fosx-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xwmx%2Fosx-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xwmx%2Fosx-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xwmx%2Fosx-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xwmx","download_url":"https://codeload.github.com/xwmx/osx-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253133119,"owners_count":21859108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["macos","osx","osx-cli","shell"],"created_at":"2025-05-08T18:49:01.196Z","updated_at":"2025-05-08T18:49:01.881Z","avatar_url":"https://github.com/xwmx.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"                            _ _\n       ___  _____  __   ___| (_)\n      / _ \\/ __\\ \\/ /  / __| | |\n     | (_) \\__ \\\u003e  \u003c  | (__| | |\n      \\___/|___/_/\\_\\  \\___|_|_|\n\n# osx-cli\n\nA collection of command line shortcuts for common OS X operations.\n\nThis is a work in progress.\n\n## Installation\n\n### Manual\n\nTo install manually, simply add the `osx` script to your `$PATH`. If\nyou already have a `~/bin` directory, you can use the following command:\n\n    curl -L https://raw.github.com/alphabetum/osx-cli/master/osx \\\n      -o ~/bin/osx \u0026\u0026 chmod +x ~/bin/osx\n\n## Commands\n\nA selection of included commands. To see the full list, run `osx\ncommands`.\n\n### `accounts`\n\n```\nUsage:\n  osx accounts (list | login \u003cusername\u003e | logout [--force] | window)\n\nSubcommands:\n  list    List login user accounts.\n  login   Log in as the specified user, aka \"Fast User Switching.\"\n  logout  Log out the current user.\n  window  Go to the OS X login window.\n\nOptions:\n  --force  Suppress confirmation prompt.\n```\n\n### `airport`\n\n```\nUsage:\n  osx airport (on | off | info | quality | scan | join \u003cSSID\u003e)\n\nSubcommands:\n  on       Turn wireless on.\n  off      Turn wireless off.\n  info     Show the current airport status.\n  quality  Show the wireless quality as a percentage.\n  scan     Perform a scan for wireless networks.\n  join     Join the specified network.\n```\n\n### `battery`\n\n```\nUsage:\n  osx battery [-l|--long]\n  osx battery status [-l|--long]\n  osx battery cycles\n  osx battery health\n\nSubcommands:\n  status  Current battery status.\n  cycles  Number of battery cycles.\n  health  Health of the battery, using the current maximum capacity as\n          percentage of the battery's design capacity).\n\nOptions:\n  -l --long  Print longform information about the battery status.\n\nDescription:\n  Print battery info. When no subcommand is specified, display `status`.\n\n```\n\n### `caffeinate`\n\n```\nUsage:\n  osx caffeinate [-disu] [-t timeout] [command] [arguments]\n\nDescription:\n  Prevent the system from sleeping on behalf of a utility.\n\n  This is simply a bookmark for the caffeinate command.\n\n  See `man caffeinate` for more information.\n\nExamples:\n  caffeinate -u -t 3600\n    Prevent sleeping for one hour (3,600 seconds).\n\n  caffeinate -s scp bigfile me:myserver/bigfile\n    Prevent sleeping until the secure file copy (scp) completes.\n```\n\n### `desktop`\n\n```\nUsage:\n  osx desktop ( hide | show )\n\nDescription:\n  Hide/show all desktop icons (useful when presenting).\n```\n\n### `eject`\n\n```\nUsage:\n  osx eject \u003cvolname\u003e\n\nDescription:\n  Ejects a given volume (eg, a disk image).\n```\n\n### `fans`\n\n```\nUsage:\n  osx fans\n\nDescription:\n  Display fan stats via iStats.\n\n  More information:\n    https://github.com/Chris911/iStats\n```\n\n### `finder`\n\n```\nUsage:\n  osx finder hidden ( hide | show )\n\nDescription:\n  Hide/show hidden files in the Finder.\n```\n\n### `jsc`\n\n```\nUsage:\n  osx jsc [\u003cfilename.js\u003e]\n\nDescription:\n  Run the JavaScriptCore REPL.\n\n  If no argument is provided, launch an interactive REPL session. If a\n  filename is provided as the second argument, run that file with jsc.\n```\n\n### `lock`\n\n```\nUsage:\n  osx lock\n\nDescription:\n  Lock the screen (when going AFK).\n```\n\n### `login-items`\n\n```\nUsage:\n  osx login-items list\n  osx login-items add \u003cpath\u003e [--hide]\n  osx login-items show ( \u003cname\u003e | \u003c/path/to/application.app\u003e\n  osx login-items delete ( \u003cname\u003e | \u003c/path/to/application.app\u003e )\n\nSubcommands:\n  list    List current login items.\n  add     Add a login item using the full path to the .app.\n  show    Print the properties for a login item using either the name, found\n          via the `list` subcommand, or the full path to the item.\n  delete  Delete a login item using either the name, found via the `list`\n          subcommand, or the full path to the item.\n\nDescription:\n  List, add, show, and delete login items.\n\n  More information:\n    https://hamstergene.github.io/post/editing-osx-login-items-cmdline/\n```\n\n### `memory`\n\n```\nUsage:\n  osx memory\n\nDescription:\n  Print memory (RAM) usage information.\n```\n\n### `play`\n\n```\nAlias for `afplay`\n\n    Audio File Play\n    Version: 2.0\n    Copyright 2003-2013, Apple Inc. All Rights Reserved.\n    Specify -h (-help) for command options\n\nUsage:\nosx play [option...] audio_file\n\nOptions: (may appear before or after arguments)\n  {-v | --volume} VOLUME\n    set the volume for playback of the file\n  {-h | --help}\n    print help\n  { --leaks}\n    run leaks analysis\n  {-t | --time} TIME\n    play for TIME seconds\n  {-r | --rate} RATE\n    play at playback rate\n  {-q | --rQuality} QUALITY\n    set the quality used for rate-scaled playback\n    (default is 0 - low quality, 1 - high quality)\n  {-d | --debug}\n    debug print output\n```\n\n### `process`\n\n```\nUsage:\n  osx process pause ( \u003cpid\u003e | -n --name \u003cname\u003e )\n  osx process continue ( \u003cpid\u003e | -n --name \u003cname\u003e )\n  osx process throttle \u003cpid\u003e \u003cmax usage\u003e\n  osx process kill ( \u003cpid\u003e | -n --name \u003cname\u003e )\n\nDescription:\n  Pause, continue, throttle, or kill a given process.\n\nDependency:\n  cputhrottle\n    http://www.willnolan.com/cputhrottle/cputhrottle.html\n```\n\n### `ql`\n\n```\nUsage:\n  osx ql \u003citem\u003e\n\nDescription:\n  Open items with Quick Look.\n```\n\n### `sleep`\n\n```\nUsage:\n  osx sleep\n\nDescription:\n  Put the system to sleep immediately.\n```\n\n### `spotlight`\n\n```\nUsage:\n  osx spotlight search ( \u003ctext\u003e | \u003cfilename\u003e )\n  osx spotlight filename \u003cfilename\u003e\n  osx spotlight disable\n  osx spotlight enable\n\nDescription:\n  Spotlight searching and controls.\n```\n\n### `sshd`\n\n```\nUsage:\n  osx sshd ( start | stop | status )\n\nDescription:\n  Start, stop, or get the status of sshd for remote login\n```\n\n### `stats`\n\n```\nUsage:\n  osx stats\n\nDescription:\n  Display temperature, fan, and battery status via iStats.\n\n  More information:\n    https://github.com/Chris911/iStats\n```\n\n### `temp`\n\n```\nUsage:\n  osx temp\n\nDescription:\n  Display CPU and battery temperature via iStats.\n\n  More information:\n    https://github.com/Chris911/iStats\n```\n\n### `textutil`\n\n```\nUsage:\n  osx textutil [command_option] [other_options] file...\n\nDescription:\n  textutil can be used to manipulate text files of various formats, using the\n  mechanisms provided by the Cocoa text system.\n\n  This is simply a bookmark for the system's textutil utility.\n\n  See `man textutil` for more information.\n\nExamples:\n  textutil -convert html MyWordFile -output /tmp/webfile.html\n    Convert a Word document into HTML.\n\n  textutil -info MyWordFile\n    Display information about the file format.\n```\n\n### `trash`\n\n```\nUsage:\n  osx trash ( empty [--secure] [--all] | open )\n\nSubcommands:\n  empty  Empty the trash.\n  open   Open the trash folder in the finder.\n\nOptions:\n  --secure  Use `srm` to securely delete trash contents.\n  --all     Empty trashes on all connected volumes.\n```\n\n### `vnc`\n\n```\nUsage:\n  osx vnc ( start | stop | status )\n\nDescription:\n  Start, stop, or get the status of vnc aka Screen Sharing aka Remote Desktop\n```\n\n### `volume`\n\n```\nUsage:\n  osx volume ( \u003c0-9\u003e | \u003c00-100\u003e | mute | unmute )\n\nArguments:\n  \u003cnone\u003e    Print the current output volume level as a percent.\n  \u003c0-9\u003e     Set the output volume to about the nearest tenth percent. Sometimes\n            the actual number is slightly off for reasons unknown.\n  \u003c00-100\u003e  Set the output volume to the specified percent.\n  mute      Mute output.\n  unmute    Unmute output.\n```\n\n## Links\n\n- [An A-Z Index of the Apple OS X command line (ss64.com)]\n(http://ss64.com/osx/)\n- [Eight Terminal Utilities Every OS X Command Line User Should Know (mitchchn.me)]\n(http://www.mitchchn.me/2014/os-x-terminal/)\n  - [comments](https://news.ycombinator.com/item?id=10143143)\n  - [followup](http://www.mitchchn.me/2014/and-eight-hundred-more/)\n\n## Related Projects\n\n- [accounts - Command line / terminal tool for common OS X user account operations.]\n(https://github.com/alphabetum/accounts)\n- [airport - A command line interface for Wi-Fi on OS X.]\n(https://github.com/alphabetum/airport)\n- [search.sh - A command line search multi-tool.]\n(https://github.com/alphabetum/search.sh)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxwmx%2Fosx-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxwmx%2Fosx-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxwmx%2Fosx-cli/lists"}