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"findallPDFfilesmodifiedinthelastweek"
# 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"backupdatabase"
# 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 /
sudo dd if=/dev/zero of=/dev/sda