feat: Add comprehensive documentation and fix exit handling

📚 Documentation Added:
- Complete docs/ directory with 5 comprehensive guides
- docs/README.md - Documentation overview and navigation
- docs/quick-start.md - 5-minute setup guide
- docs/commands.md - Complete commands and tools reference
- docs/configuration.md - Advanced configuration options
- docs/troubleshooting.md - Solutions for common issues

🔧 Exit Handling Fixes:
- Proper signal handling for SIGINT and SIGTERM
- Support for multiple exit commands: exit, quit, bye, q
- Enhanced KeyboardInterrupt and EOFError handling
- Graceful shutdown with proper async cleanup
- Fixed infinite input loops on exit

📖 Enhanced README:
- Modern GitHub README with comprehensive examples
- Rich terminal UI screenshots and examples
- Clear comparison with traditional CLIs
- Architecture overview and key features
- Complete troubleshooting section

🎯 User Experience Improvements:
- Multiple ways to exit (Ctrl+C, exit, quit, bye, q)
- Better error messages and help documentation
- Step-by-step guides for common tasks
- Complete API reference and configuration options

Author: Codestral CLI Dev

README.md

@@ -1,29 +1,31 @@
 # 🤖 Codestral CLI
 
-A GitHub Copilot-style terminal interface for **Codestral** - Mistral's code generation AI. Real-time streaming responses with beautiful terminal UI.
+A modern GitHub Copilot-style terminal interface for **Codestral** - Mistral's code generation AI. Real-time streaming responses with beautiful terminal UI and powerful developer tools.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![Codestral](https://img.shields.io/badge/AI-Codestral-purple.svg)](https://codestral.mistral.ai/)
 
 ## ✨ Features
 
 - 💬 **Interactive Chat** - GitHub Copilot-like terminal experience  
-- ⚡ **Real-time Streaming** - See responses as they generate
-- 🎨 **Rich Terminal UI** - Beautiful formatting and live updates
-- 🛠️ **Developer Tools** - Built-in commands for code review, debugging
-- 🚀 **Fast & Modern** - Async architecture for responsive UX
+- ⚡ **Real-time Streaming** - See responses as they generate, token by token
+- 🎨 **Rich Terminal UI** - Beautiful formatting with live updates and markdown support
+- 🛠️ **Developer Tools** - Built-in commands for code review, debugging, explanations
+- 🚀 **Async Architecture** - Non-blocking, responsive interface
+- 🔧 **Easy Setup** - One-command installation with automatic SSL handling
 
 ## 🚀 Quick Start
 
 ### Installation
 ```bash
-git clone https://github.com/yourusername/codestral-cli.git
+git clone https://github.com/momominds/codestral-cli.git
 cd codestral-cli
-pip install -r requirements.txt
+./install.sh
 ```
 
-### Setup
+### Setup API Key
+Get your API key from [Mistral Console](https://console.mistral.ai/):
 ```bash
 export MISTRAL_API_KEY="your-api-key"
 ```
@@ -36,89 +38,166 @@ codestral-cli
 # Single prompt  
 codestral-cli "Write a Python function to sort a list"
 
-# With token limit
+# With options
 codestral-cli "Explain async Python" --max-tokens 500
 ```
 
-## 💻 Interactive Commands
-
-Once in interactive mode, use these commands:
+## 💻 Interactive Experience
 
 ```bash
-# Basic commands
-help          # Show help
-clear         # Clear conversation  
-exit          # Quit
-
-# Developer tools  
-/explain ls -la       # Explain shell commands
-/review myfile.py     # Code review
-/commit               # Generate commit message
-/debug "error msg"    # Debug help
+$ codestral-cli
+
+🚀 Codestral CLI (Async Mode)
+Model: codestral-latest • Streaming: ON • Rich UI: ON
+
+👤 You: How do I handle errors in Python?
+
+╭─────────────────────────────── 🤖 Codestral ────────────────────────────────╮
+│ Error handling in Python is done using try-except blocks:                   │
+│                                                                              │
+│ ```python                                                                    │
+│ try:                                                                         │
+│     # Code that might raise an exception                                     │
+│     result = 10 / 0                                                          │
+│ except ZeroDivisionError:                                                    │
+│     print("Cannot divide by zero!")                                          │
+│ except Exception as e:                                                       │
+│     print(f"An error occurred: {e}")                                         │
+│ finally:                                                                     │
+│     print("This always executes")                                            │
+│ ```                                                                          │
+╰──────────────────────────── Tokens: 45 • Time: 1.2s ───────────────────────╯
+
+👤 You: /review app.py
+🤖 Codestral: [Reviews your code file...]
+
+👤 You: exit
+👋 Goodbye!
 ```
 
+## 🛠️ Developer Tools
+
+Built-in commands accessible with `/command`:
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `/explain <cmd>` | Explain shell commands | `/explain docker run -it ubuntu` |
+| `/review <file>` | Code review and feedback | `/review src/main.py` |
+| `/commit` | Generate commit messages | `/commit` |
+| `/debug <error>` | Debug help | `/debug "ImportError: No module named 'requests'"` |
+| `/suggest <task>` | Suggest commands | `/suggest "deploy to AWS"` |
+| `/analyze <file>` | Code structure analysis | `/analyze package.json` |
+| `/test <file>` | Generate unit tests | `/test utils.py` |
+| `/docs <code>` | Generate documentation | `/docs "def hello(): return 'world'"` |
+
 ## ⚙️ Configuration
 
-Set your API key:
+### Environment Variables
 ```bash
-export MISTRAL_API_KEY="your-key-here"
+export MISTRAL_API_KEY="your-key"              # Required
+export MISTRAL_MODEL="codestral-latest"        # Optional
+export MISTRAL_MAX_TOKENS=2000                 # Optional
 ```
 
-Optional environment variables:
-```bash
-export MISTRAL_MODEL="codestral-latest"     # Default model
-export MISTRAL_BASE_URL="https://..."       # Custom endpoint
+### Config File (`~/.codestral/config.json`)
+```json
+{
+  "api_key": "your-key",
+  "model": "codestral-latest", 
+  "max_tokens": 2000,
+  "temperature": 0.1
+}
 ```
 
-### 🔒 SSL Certificate Issues
+## 🔧 Command Line Options
+
+```bash
+codestral-cli [prompt] [options]
+
+Arguments:
+  prompt                    Prompt to send (if not provided, enters interactive mode)
 
-If you encounter SSL certificate errors:
+Options:
+  --max-tokens INT         Maximum tokens in response
+  --version               Show version information
+  --help                  Show help message
+```
+
+## 🆘 Troubleshooting
 
+### SSL Certificate Issues
+If you get SSL certificate errors:
 ```bash
-# Quick fix
+# Automatic fix
 python3 fix_ssl.py
 
-# Manual fixes
+# Manual fix
 pip3 install --upgrade certifi
-export PYTHONHTTPSVERIFY=0  # Temporary bypass (not recommended)
 
-# macOS specific
-/Applications/Python\ 3.x/Install\ Certificates.command
+# Temporary bypass (not recommended for production)
+PYTHONHTTPSVERIFY=0 codestral-cli "test prompt"
 ```
 
-## 🎯 Examples
+### Common Issues
+- **API Key**: Make sure `MISTRAL_API_KEY` is set correctly
+- **Dependencies**: Run `pip3 install -r requirements.txt`
+- **Permissions**: Run `chmod +x install.sh main.py fix_ssl.py`
 
-### Code Generation
-```bash
-$ codestral-cli "Create a FastAPI hello world app"
+## 📚 Documentation
 
-🤖 Codestral: Here's a simple FastAPI application:
+Complete documentation available in the [`docs/`](docs/) directory:
 
-```python
-from fastapi import FastAPI
+- **[Quick Start Guide](docs/quick-start.md)** - Get up and running in 5 minutes
+- **[Commands Reference](docs/commands.md)** - All available commands and tools
+- **[Configuration Guide](docs/configuration.md)** - Advanced configuration options
+- **[Troubleshooting](docs/troubleshooting.md)** - Solutions for common issues
 
-app = FastAPI()
+## 🎯 Key Differences from Traditional CLIs
 
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-```
+| Traditional CLI | Codestral CLI |
+|----------------|---------------|
+| Block and wait | ⚡ Stream live responses |
+| Plain text output | 🎨 Rich markdown formatting |
+| Single request/response | 💬 Conversational context |
+| No developer tools | 🛠️ Built-in code tools |
+| Basic error handling | 🔧 Comprehensive troubleshooting |
 
-### Interactive Session
-```bash
-$ codestral-cli
+## 🏗️ Architecture
 
-🚀 Codestral CLI  
-Type your message and press Enter. Use 'help' for commands.
+- **Async Streaming**: Real-time token-by-token responses using `aiohttp`
+- **Rich Terminal UI**: Beautiful formatting with `rich` library
+- **Modular Tools**: Extensible developer tool system
+- **Smart Error Handling**: SSL troubleshooting and helpful error messages
+- **Clean Configuration**: Multiple config methods with priority system
 
-👤 You: How do I handle errors in Python?
+## 🤝 Contributing
 
-🤖 Codestral: [streaming response...]
-```
+We welcome contributions! Please see:
+- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guidelines
+- **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** - Community standards
+- **[Issues](https://github.com/momominds/codestral-cli/issues)** - Bug reports and feature requests
 
-## 📝 License
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **[Mistral AI](https://mistral.ai/)** for the excellent Codestral model
+- **[Rich](https://github.com/Textualize/rich)** for beautiful terminal UI
+- The Python async ecosystem (`aiohttp`, `asyncio`)
+- The open-source community for inspiration and feedback
+
+## 🔗 Links
+
+- **GitHub Repository**: https://github.com/momominds/codestral-cli
+- **Mistral AI**: https://mistral.ai/
+- **Codestral API**: https://docs.mistral.ai/capabilities/code_generation/
+- **Get API Key**: https://console.mistral.ai/
+
+---
 
-MIT License - see [LICENSE](LICENSE) for details.
+**Built with ❤️ for developers who love beautiful, responsive terminal experiences.**
 
 # Use with any OpenAI-compatible tool
 export OPENAI_API_BASE="http://localhost:8080/v1"