🚀 Manx - Lightning-Fast Documentation Finder

Find code snippets, documentation, and answers instantly from your terminal

📚 Setup Guide • 🔍 Commands • ⚙️ Configuration • 🧠 AI Features

⚡ Quick Start

# Install
cargo install manx-cli

# Find code snippets instantly
manx snippet react "useState hook"
manx snippet python "async functions"

# Search documentation
manx search "rust error handling"
manx doc fastapi "middleware"

That's it! Works immediately with no setup required.

✨ What is Manx?

Manx helps developers find answers fast with four powerful modes:

Progressive Enhancement

Start simple → Add semantic search → Index your docs → Enable AI

🎯 Core Features

Code Snippet Search

manx snippet react "custom hooks"
manx snippet python "decorators" 
manx snippet rust "error handling"

Get working code examples with explanations from official documentation

Documentation Search

manx search "authentication best practices"
manx doc fastapi "dependency injection"

Search official docs across hundreds of frameworks and languages

Personal Knowledge Base

manx index ~/dev-notes/
manx search "team coding standards" --rag

Index and search your own documentation with semantic understanding

AI-Powered Analysis (Optional)

manx config --openai-api "sk-your-key"
manx snippet react hooks  # Now includes AI explanations

Get comprehensive answers with code examples, explanations, and citations

📚 Learn More

• 🔧 Setup Guide - Complete installation and configuration
• 📖 Commands Reference - All commands with examples
• ⚙️ Configuration - Customize settings and providers
• 🧠 AI Features - LLM integration and capabilities
• 📁 RAG Mode - Index and search personal documentation
• 🔍 Neural Search - Enhanced semantic understanding

🏃‍♂️ Daily Workflows

Quick Development

manx snippet python "list comprehensions"     # Learning
manx search "javascript memory leaks"         # Debugging  
manx doc svelte "component lifecycle"         # Reference

Team Knowledge

manx index ~/team-docs/                       # One-time setup
manx search "deployment checklist" --rag      # Daily usage

Research Mode

manx config --openai-api "sk-key"            # Enable AI
manx search "microservices architecture"      # Get comprehensive analysis

🚀 Why Manx?

• ⚡ Instant: Works immediately after installation
• 🎯 Accurate: Searches official documentation, not forums
• 🧠 Smart: Optional semantic search understands intent
• 🔒 Private: Your documents never leave your machine
• ⚙️ Flexible: Choose your level of enhancement
• 🚀 Fast: Optimized Rust performance with embedded ONNX Runtime

📦 Installation

Cargo (Recommended)

cargo install manx-cli

Other Options

• Binary: Download from GitHub Releases
• Script: curl -fsSL https://raw.githubusercontent.com/neur0map/manx/main/install.sh | bash

🆘 Getting Help

• 📖 Documentation: Check the guides linked above
• 🐛 Issues: GitHub Issues
• 💡 Feature Requests: Discussions

📄 License

MIT © neur0map

Happy coding! 🚀