🦋 Moth AI

The World's First Truly Open CLI Assistant for Local & Open Source Models

Overview

Moth AI is the first terminal-native coding assistant built from the ground up to treat local and open-source LLMs as first-class citizens. While others lock you into proprietary models or cloud subscripts, Moth is truly open source—in code, philosophy, and model support.

It empowers you to write, debug, refactor, and reason about code using your own models on your own hardware. Whether you're running Llama 3 on a MacBook or GPT-4 in the cloud, Moth gives you the same powerful agentic capabilities without the compromise.

🚀 Key Features

🔓 Truly Open & Local-First

Moth is the only CLI tool designed to democratize AI access.

• Local Native: Optimized deeply for Ollama. Run Llama 3, Mistral, Gemma, or DeepSeek locally with zero latency, 100% privacy, and no internet connection required.
• Open Source First: We support any OpenAI-compatible endpoint, making it universally compatible with the open ecosystem of model servers (LM Studio, LocalAI, etc.).
• Cloud Optional: Seamlessly integrate OpenAI (GPT-4), Anthropic (Claude), or Google (Gemini) when you need extra horsepower—but only when you choose to.

🤖 Agentic Capabilities with Role-Based Modes

Moth operates in three distinct modes to match your current task intensity:

1. 🔵 Default Mode: A balanced assistant that asks for permission before executing sensitive actions.
2. � Plan Mode: Prioritizes detailed architectural planning. Moth creates comprehensive markdown plans for review before writing a single line of code.
3. 🚀 Autopilot Mode: For trusted workflows. Moth executes authorized tool calls automatically, streamlining repetitive tasks.

🛡️ Secure & Transparent

• Permission-First Architecture: You approve every significant file edit or shell command.
• Context-Aware: Moth intelligently scans your project structure to provide relevant answers, not hallucinations.

📦 Installation

Global Installation (Recommended)

Install Moth AI globally to access the moth command from any directory.

npm install -g moth-ai

Local Installation

For project-specific constraints.

npm install moth-ai
npx moth-ai

Requirements: Node.js >= 18.0.0

⚡ Quick Start

1. Initialize Moth:

   moth

2. Configure Your First Profile: Run the interactive setup wizard to connect your preferred model.

   moth llm add

3. Execute Commands:
   • Chat: Simply type your query.
   • Command Palette: Press Ctrl+U to manage profiles and settings.
   • Switch Modes: Press Ctrl+B to cycle operational modes.

*Moth AI — Coding at the speed of thought.*