maid

It’s great to see more tools taking advantage of the markdown syntax. I’m the creator of Mask[0], a very similar tool built with Rust. I was originally inspired by Maid[1], which is an older take on this idea built with Node and no longer maintained I believe. I see this is based on Node as well, and I appreciate that it currently has zero dependencies. Nice work! [0]: https://github.com/jacobdeichert/mask [1]: https://github.com/egoist/maid

A few years back on my project Takeoff (https://github.com/takeoff-env/takeoff) - a tool for creating docker environments for local dev - I used maid (https://github.com/egoist/maid) for exactly this, using a markdown file as a task runner. I liked the idea, although didn't go much further with the project.

I prefer my readmes in plain text formats, be it Markdown, AsciiDoc, or unstructured txt. This reminds me of two interesting projects, maid[0], a task runner that uses markdown files, and mandown[1], a markdown pager that improves reading markdown files in the terminal. [0]: https://github.com/egoist/maid [1]: https://github.com/Titor8115/mandown

Hey! So this tool is something that I've wanted to build for a while now and it was a good opportunity to improve my Rust skills. It's inspired by a few other tools such as just [1] and maid [2]. The readme's faq section has some more background on why I wanted to build this. To summarize mask, it's a cli tool that looks for a maskfile.md in the current directory and parses it for commands. A maskfile.md is both a human-readable document and a simple command definition format. Tasks can be defined in sh, bash, zsh, fish, js, python, php, and ruby. Though it's not at v1.0 yet, I've been using it daily in personal projects and also as a global system utility for handy commands and automation tasks. Happy to answer any questions! [1]: https://github.com/casey/just [2]: https://github.com/egoist/maid

This seems like a cool idea, but I'm hesitant to run it locally. Is an early version of the application with no unit tests and it eagerly calls `sh` command with string input ( see: https://github.com/egoist/maid/blob/master/lib/index.js ) I would be worried that some parse error or non-obvious typo in the Markdown format could result in `sh` accidentally running something destructive locally. Still though, I like the idea and am now following the project, you should keep working on it! You may want to consider running the Node tasks in a separate subprocess instead of using `require-from-string` module in parent process. You could also try using https://github.com/stackvana/microcule to add support for subprocess execution and multiple programming languages.