mang.sh - Natural Language to Terminal Commands

Describe a task; Mang proposes a terminal command. Inspect it and explicitly confirm before execution. Use local Ollama or OpenRouter. Built in Rust. MIT-licensed.

Add a comment

Replies

Best

1/4 · I made Mang for the moment when you know what you want to do but can't remember the shell syntax.

Describe the task in ordinary language and Mang proposes a terminal command.

You inspect it, then explicitly confirm before anything runs. It works with local Ollama or OpenRouter, so you choose your own trade-offs on data, capability and cost. I like that the proposed command comes with an explanation, because the aim is to help you understand the terminal a little better each time, not to hide it from you.

That last pause is the point. A plausible command can still be wrong, destructive or simply wrong for your machine. Mang helps with the terminal; it isn't permission to stop reading it.


This is day three of the Weekathon, seven free and open-source launches in seven days, and I wanted a small, repeatable workflow rather than another all-purpose AI subscription. The code is MIT-licensed, so you can adapt it to the way you work and share improvements back.


Try a task you actually do. Was the proposed command easy to understand, and what would help you review it with more confidence?

2/4 · Execution, model choice and safety

The yo command takes a plain-language request, proposes a command and gives an explanation. You confirm before execution. It can route through local Ollama or OpenRouter, depending on your setup.


I see it as help with translation, not a reason to stop reading commands. Destructive operations, private paths and a wrong working directory still have consequences. Please test unfamiliar suggestions in a safe environment.


Local inference requires suitable hardware; remote inference has provider costs and data-handling implications. Those belong in the decision, not in the footnotes after deployment.


Get started:

Read the source:

Weekathon context:

3/4 · Where the tool should wait for you

My wall of fame includes complicated lives as well as celebrated contributions. The practical lesson I bring to Mang is simple: encourage curiosity, make consequences legible, and keep permission with the person at the keyboard.


The third Weekathon release therefore has a different design question from the first two: where should the software explicitly wait for its user?


Mang makes one CHO decision tangible: choose a model and workflow against the job, rather than asking every colleague to rediscover the same setup. Local Ollama and hosted OpenRouter have different cost and data boundaries. A small self-hosted model might suit a narrow command task; representative tests must establish that.

Keep those tests, permissions and operating notes with the code. Hardware, maintenance, model licensing and mistakes belong in the comparison. Central ownership of a tool does not remove the user's decision to approve a command.

4/4 · Take it further

The repository is MIT-licensed, including the right to adapt or commercialise it with the notices retained. A useful contribution might be a poorly explained command, an ambiguous request or a better test for a risky edge case.


If you use an AI to work on it, give it that specific case, a budget and an acceptance test. Check the actual command behaviour, not just the prose explaining it. I'll use the same approach when prioritising public reports and funding manageable follow-up changes.


The CHO (Chief Hacking Officer) title is deliberately playful; the role is serious. I'm open to a CHO brief of up to 30h/week with a great company or startup, a worthwhile product, trust and a modest budget.


Outside this open-source release, I'm also raising funds for Openline (), my main startup: the aim is to reshape the eSIM market, with a deep pipeline of ideas ready to execute. Angels and VCs interested in the founder's work are welcome to start a separate conversation via , no need to wait for the 1 December launch.


Enki (), a public-good, local-first AI initiative with open blueprints, launches on Product Hunt on Tuesday 24 November. It's too big for me alone, and needs people with more talent, connections and resources than I can bring alone.


I'm at Web Summit in Lisbon today (its last day), where I live, shipping Mang between conversations. Happy to meet today or later around Lisbon, if you're interested in the work or want to help with Enki: X () or .