# 🚀 Manx - Lightning-Fast Documentation Finder
> *Find code snippets, documentation, and answers instantly from your terminal*
<div align="center">
**📚 [Setup Guide](SETUP_GUIDE.md) • 🔍 [Commands](COMMANDS.md) • ⚙️ [Configuration](CONFIGURATION.md) • 🧠 [AI Features](AI_FEATURES.md)**
</div>
## ⚡ Quick Start
```bash
# 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:
| **🚀 Default** | None | Official docs + keyword search (works instantly) |
| **🧠 Enhanced** | 1 command | Neural search + semantic understanding |
| **📁 RAG** | Index docs | Search your private documentation |
| **🤖 AI** | Add API key | Full synthesis with explanations + citations |
### Progressive Enhancement
Start simple → Add semantic search → Index your docs → Enable AI
## 🎯 Core Features
### **Code Snippet Search**
```bash
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**
```bash
manx search "authentication best practices"
manx doc fastapi "dependency injection"
```
*Search official docs across hundreds of frameworks and languages*
### **Personal Knowledge Base**
```bash
manx index ~/dev-notes/
manx search "team coding standards" --rag
```
*Index and search your own documentation with semantic understanding*
### **AI-Powered Analysis** *(Optional)*
```bash
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](SETUP_GUIDE.md)** - Complete installation and configuration
- **📖 [Commands Reference](COMMANDS.md)** - All commands with examples
- **⚙️ [Configuration](CONFIGURATION.md)** - Customize settings and providers
- **🧠 [AI Features](AI_FEATURES.md)** - LLM integration and capabilities
- **📁 [RAG Mode](RAG_GUIDE.md)** - Index and search personal documentation
- **🔍 [Neural Search](NEURAL_SEARCH.md)** - Enhanced semantic understanding
## 🏃♂️ Daily Workflows
### **Quick Development**
```bash
manx snippet python "list comprehensions" # Learning
manx search "javascript memory leaks" # Debugging
manx doc svelte "component lifecycle" # Reference
```
### **Team Knowledge**
```bash
manx index ~/team-docs/ # One-time setup
manx search "deployment checklist" --rag # Daily usage
```
### **Research Mode**
```bash
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)
```bash
cargo install manx-cli
```
### Other Options
- **Binary**: Download from [GitHub Releases](https://github.com/neur0map/manx/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](https://github.com/neur0map/manx/issues)
- **💡 Feature Requests**: [Discussions](https://github.com/neur0map/manx/discussions)
## 📄 License
MIT © [neur0map](https://github.com/neur0map)
---
*Happy coding! 🚀*
