Skip to content

RUNME.sh is a tiny toolkit for creating bash cli utilities fast, simple and easy.

License

Notifications You must be signed in to change notification settings

mipmip/RUNME.sh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RUNME.sh

Description

RUNME.sh is a suckless single-file boilerplate for creating bash cli utilities fast, simple and easy.

  • Just one dependency: a sh compatible shell.
  • Boilerplate has only 11 lines of code, including comments.
  • Little bash knowledge needed
  • Makes "USAGE:" banners automatically
  • Drop in solution for cleaning up collections of scripts
  • Perfect for self documenting small projects

RUNME.sh is so simple you could have written it yourself.

Why I wrote RUNME.sh

I often use make or rake for small projects. This is really overkill as I only need to run some tasks and add some quick instructions for my later self. RUNME.sh does exacly the same.

Quickstart

  • Run this command in you project folder
curl -O https://raw.githubusercontent.com/mipmip/runme.sh/master/RUNME.sh && chmod +x RUNME.sh
  • Edit RUNME.sh, see how the demo command is works, and add your own commands
  • Run it...
$ ./RUNME.sh

Usage: ./RUNME.sh command

Commands:
  demo            this command is for explaining how run-me works

Contributing

If you would like to help, please send pull request of submit an issue.

License

Released under the MIT License. See the LICENSE file for further details.

About

RUNME.sh is a tiny toolkit for creating bash cli utilities fast, simple and easy.

Topics

Resources

License

Stars

Watchers

Forks

Languages