camo-cli 2.0.1

package/README.md

@@ -0,0 +1,184 @@
+# 🦎 CAMO CLI
+
+Ein intelligenter Terminal-AI-Assistent mit Multi-Provider-Support und professionellem TUI.
+
+## Features
+
+✨ **Multi-Provider Support**: Anthropic, OpenAI, Google, Groq + Custom  
+🎨 **Professionelles TUI**: Claude Code-Style Interface  
+🔧 **Tool Integration**: File Operations, Code Search, Shell Commands  
+📊 **Git-Style Diffs**: Rot/Grün Code-Änderungen  
+💾 **Persistente Config**: Sichere API-Key Verwaltung  
+🌊 **Streaming Responses**: Echtzeit-Antworten  
+
+## Installation
+
+### Lokal testen
+
+```bash
+# Dependencies installieren
+npm install
+
+# Projekt builden
+npm run build
+
+# CLI testen
+node dist/index.js
+```
+
+### Global installieren
+
+```bash
+# Global verlinken (für Entwicklung)
+npm link
+
+# Jetzt kannst du überall `camo` verwenden
+camo
+```
+
+## Verwendung
+
+### 1. Setup: API-Key konfigurieren
+
+Beim ersten Start wirst du nach einem Provider und API-Key gefragt:
+
+```bash
+camo
+```
+
+Oder direkt via Befehl:
+
+```bash
+# Im interaktiven Modus
+/key anthropic sk-ant-...
+/key openai sk-...
+/key google AIza...
+/key groq gsk_...
+```
+
+### 2. Modell auswählen
+
+```bash
+# Alle verfügbaren Modelle anzeigen
+/model list
+
+# Spezifisches Modell wählen
+/model anthropic/claude-3-5-sonnet-latest
+/model openai/gpt-4o
+/model google/gemini-2.0-flash-exp
+```
+
+### 3. Mit CAMO chatten
+
+Einfach deine Frage eingeben - CAMO antwortet in Echtzeit! 🦎
+
+## Verfügbare Befehle
+
+### Provider & Modell Management
+
+- `/key <provider> <api-key>` - API-Key setzen
+- `/model list` - Alle Modelle anzeigen
+- `/model <provider>/<model-id>` - Modell wählen
+- `/provider list` - Alle Provider anzeigen
+- `/provider add <name> <url> <key>` - Custom Provider hinzufügen
+- `/provider remove <name>` - Provider entfernen
+
+### System
+
+- `/help` - Hilfe anzeigen
+- `/clear` - Chat-Historie löschen
+- `/exit` - CAMO beenden
+
+### MCP (Model Context Protocol)
+
+- `/mcp list` - MCP-Server anzeigen
+- `/mcp add <config>` - MCP-Server hinzufügen
+
+## Unterstützte Provider & Modelle
+
+### Anthropic
+- Claude 3.5 Sonnet (200k context)
+- Claude 3.5 Haiku (200k context)
+- Claude 3.7 Sonnet (200k context)
+
+### OpenAI
+- GPT-4o (128k context)
+- GPT-4o Mini (128k context)
+- O1 (200k context)
+- O1 Mini (128k context)
+
+### Google
+- Gemini 2.0 Flash (1M context)
+- Gemini 2.5 Pro (2M context)
+
+### Groq
+- Llama 3.3 70B (128k context)
+- Mixtral 8x7B (32k context)
+
+### Custom
+- Jeder OpenAI-kompatible Endpoint
+
+## Beispiele
+
+```bash
+# Einfache Frage
+Erkläre mir TypeScript in einem Satz
+
+# Code-Hilfe
+Schreibe eine TypeScript Funktion die zwei Zahlen addiert
+
+# Datei-Operationen
+Erstelle eine neue Datei utils.ts mit Helper-Funktionen
+
+# Code-Suche
+Suche nach allen TODO-Kommentaren im Projekt
+```
+
+## Projekt-Struktur
+
+```
+camo-cli/
+├── src/
+│   └── index.ts        # CLI mit AI-Integration
+├── dist/               # Kompilierte JavaScript-Dateien
+├── package.json        # NPM Konfiguration mit bin-Feld
+├── tsconfig.json       # TypeScript Konfiguration
+└── README.md           # Diese Datei
+```
+
+## Technologien
+
+- **TypeScript**: Typsicherer Code
+- **Node.js**: Runtime
+- **AI SDK**: Vercel AI SDK für Streaming
+- **Anthropic**: Claude 3.5 Sonnet
+- **OpenAI**: GPT-4o
+- **Google**: Gemini 2.0 Flash
+- **commander**: CLI-Framework
+- **conf**: Persistente Konfiguration
+- **chalk**: Farbige Terminal-Ausgabe
+
+## Entwicklung
+
+```bash
+# Mit ts-node direkt ausführen (ohne Build)
+npm run dev
+
+# Projekt neu builden
+npm run build
+```
+
+## Fehlerbehandlung
+
+CAMO erkennt automatisch:
+- ❌ Fehlende API-Keys
+- ❌ Ungültige API-Keys
+- ❌ Rate Limits
+- ❌ Netzwerkfehler
+
+Und gibt hilfreiche Fehlermeldungen aus.
+
+## Lizenz
+
+ISC
+