Open Source Tool
$_
magic-shell

Type what you mean. Execute what you need.

Transform natural language into terminal commands with AI-powered translation and built-in safety features.

terminal
$
->
magic-shell
grok-code
Provider: opencode-zen Model: grok-code Safe Mode
>
Command:
Low risk
~>
Ctrl+X M Model Ctrl+X T Theme Ctrl+X D Dry-run Ctrl+X ? Help

Everything you need

Powerful features that make command-line work feel like magic.

~>

Natural Language

Describe what you want in plain English. Magic Shell translates it to the right command for your shell.

<>

Multiple AI Providers

Choose between OpenCode Zen (with free models!) and OpenRouter for access to the best AI models.

!!

Safety Analysis

Every command is analyzed for risk before execution. Dangerous patterns are blocked automatically.

[]

Beautiful TUI

Full interactive terminal interface with 8 themes, command history, and keyboard shortcuts.

{}

Project Aware

Opt-in context detection reads your package.json scripts, Makefile targets, and more. Say 'run dev' and it knows what to do.

$_

Shell-Aware

Automatically detects bash, zsh, fish, PowerShell, and more. Commands adapt to your shell's syntax.

^v

Auto Updates

Checks for updates automatically and notifies you when a new version is available. Always stay current.

Two ways to use

Choose the workflow that fits your style.

[]

Interactive TUI

Recommended

A full terminal interface with themes, history, model switching, and safety analysis. Perfect for exploration and extended sessions.

launch
$ mshell
  • 8 beautiful themes
  • Command history
  • Switch models on the fly
  • Keyboard shortcuts
$_

Quick CLI

One-shot commands for fast translations. Pipe output, use in scripts, or execute directly with -x.

examples
$ msh "find large files" find . -type f -size +100M $ msh -x "show disk usage"
  • Quick one-liners
  • Pipe to clipboard
  • Script-friendly
  • Dry-run with -n

Built-in safety

Every command is analyzed before execution. Dangerous patterns are blocked.

Low
low

Worth reviewing before running

$ git checkout main
Medium
medium

Requires elevated privileges

$ sudo apt install
High
high

Significant changes or data loss risk

$ rm -rf node_modules
Critical
critical

Blocked - could cause system damage

$ rm -rf /

8 beautiful themes

Match your terminal aesthetic. Switch themes anytime with Ctrl+X T.

magic-shell
$ msh "find large files"
find . -type f -size +100M

Get started in seconds

One command to install. Works on macOS, Linux, and Windows.

$ bun add -g @austinthesing/magic-shell
$ npm install -g @austinthesing/magic-shell
$ pnpm add -g @austinthesing/magic-shell

Then run msh --setup to configure your API key, and mshell to launch the TUI.