Get Started

What is Mako?

Mako is an AI-native shell orchestrator that wraps around your existing shell (bash/zsh) to provide intelligent command assistance. Generate commands from natural language, search your history semantically, and work faster with an AI that understands context.

Unlike traditional command-line tools, Mako intercepts terminal I/O through a PTY (pseudo-terminal) and routes commands to AI for natural language processing, making your command-line experience more intuitive and productive.

How It Works

  1. Start Mako - Wraps around your bash/zsh shell
  2. Natural Language - Type mako ask "compress this video"
  3. AI Generation - Your configured AI provider generates the appropriate shell command
  4. Review & Execute - Review the command before running it
  5. Learn & Improve - Mako learns your preferences over time

Key Features

Natural Language Commands

Generate shell commands from plain English. No need to remember complex syntax.

makoask"find all PDF files modified in the last week"
# Generates: find . -name "*.pdf" -mtime -7

Semantic History Search

Search your command history by meaning, not exact text. Find that command you ran months ago.

makohistorysemantic"backup database"
# Finds commands like: pg_dump -U postgres mydb > backup.sql

Context-Aware AI

Mako understands your current directory, recent output, and command patterns to provide better suggestions.

Safety First

Detects potentially dangerous commands before execution. Prevents accidental data loss.

# Mako will warn you about:
rm -rf /
sudoddif=/dev/zeroof=/dev/sda