Installation & Dokumentation

Über Kobel

Kobel ist eine Desktop-Anwendung für Windows und macOS, die als kontrollierte Schleuse zwischen KI-Apps (Claude Desktop, Cursor, Gemini CLI u. a.) und deinen lokalen Dateien agiert. Du entscheidest pro Ordner, welche KI Zugriff bekommt und mit welchen Rechten (lesen, schreiben, nur Kopien bearbeiten, gesperrt). Kobel selbst läuft vollständig lokal und lädt nichts hoch — was eine verbundene KI mit den freigegebenen Dateien macht, richtet sich nach deren Datenschutzbestimmungen.

Systemanforderungen

Windows

• Betriebssystem: Windows 10 (Version 1809 oder neuer) oder Windows 11 — jeweils 64-Bit (x64)
• Arbeitsspeicher: ca. 300 MB RAM während der Nutzung
• Festplatte: ca. 200 MB freier Speicher für die Installation
• Laufzeitumgebung (nur Windows): Microsoft Edge WebView2 Runtime (in Windows 11 bereits enthalten, wird bei Windows 10 bei Bedarf automatisch nachinstalliert). Auf dem Mac brauchst du sie nicht.
• Netzwerk: Eine Internetverbindung wird nur für Lizenzaktivierung und Updates benötigt — der normale Betrieb erfolgt offline

macOS

• Betriebssystem: macOS 13 oder neuer
• Prozessor: Macs mit Apple Silicon und Intel-Macs
• Bezugsquelle: Mac App Store (die Basis-Version ist kostenlos)
• Netzwerk: Eine Internetverbindung wird nur für die Anmeldung und für Updates über den Mac App Store benötigt — der normale Betrieb erfolgt offline

Installation unter Windows

1. Installation starten: Öffne den Microsoft Store und installiere Kobel per Klick. Für Unternehmens-Deployments steht zusätzlich ein MSI-Installer bereit.
2. Installer ausführen: Starte die heruntergeladene Datei per Doppelklick. Windows zeigt ggf. einen SmartScreen-Hinweis — bestätige über „Weitere Informationen" → „Trotzdem ausführen". Kobel ist signiert und von Microsoft verifiziert.
3. Installationspfad wählen: Der Installer schlägt einen Standardpfad vor. Bestätige mit „Weiter".
4. Installation abschließen: Der Vorgang dauert typischerweise 10–20 Sekunden.
5. Erststart: Beim ersten Start öffnet sich Kobel automatisch und führt dich durch eine kurze Einrichtung (Sprachwahl, erste Ordnerfreigabe, KI-App verbinden).
6. System-Tray: Nach dem ersten Start läuft Kobel im Hintergrund und ist über das Kobel-Symbol im System-Tray (rechts unten in der Taskleiste) erreichbar. Rechtsklick öffnet das Kontextmenü, Linksklick öffnet das Hauptfenster.

Installation unter macOS

1. Kobel im Mac App Store öffnen: Ruf Kobel im Mac App Store auf und klicke auf „Laden". Die Basis-Version ist kostenlos.
2. Installation abschließen: Den Rest erledigt der Mac App Store — Kobel wird geladen und in den Ordner „Programme" installiert. Einen separaten Installer gibt es auf dem Mac nicht.
3. Erststart: Starte Kobel über das Launchpad oder aus dem Ordner „Programme". Beim ersten Start führt dich Kobel durch eine kurze Einrichtung (Sprachwahl, erste Ordnerfreigabe, KI-App verbinden).
4. Menüleiste: Danach läuft Kobel im Hintergrund und ist über das Kobel-Symbol in der Menüleiste (oben rechts im Bildschirm) erreichbar. Auf dem Mac heißt dieser Bereich Menüleiste — ein System-Tray wie unter Windows gibt es hier nicht.
5. Pro freischalten: Wähle in der App die Anmeldung per E-Mail und gib die E-Mail-Adresse ein, die du beim Kauf verwendet hast. Du bekommst einen sechsstelligen Einmalcode per E-Mail, tippst ihn in Kobel ein — fertig. Ein Feld für Lizenzschlüssel gibt es auf dem Mac nicht, weil Apple das in App-Store-Apps nicht erlaubt; nötig ist es auch nicht, die App holt sich den Schlüssel selbst. Der Code gilt zehn Minuten und nur für diese eine Anmeldung.

Silent Install für IT-Administratoren (nur Windows)

Dieser Abschnitt und die unten dokumentierten Installer-Rückgabecodes gelten ausschließlich für den Windows-Installer. Die Mac-Version wird ausschließlich über den Mac App Store verteilt.

Für automatisierte Rollouts (z. B. über Intune, SCCM oder Gruppenrichtlinien) unterstützt der Installer einen stillen Installationsmodus ohne Benutzerinteraktion:

Kobel_1.0.0_x64-setup.exe /S

Der Installer läuft im Hintergrund, zeigt keine UI und beendet sich nach Abschluss. Die Rückgabecodes der Datei entsprechen den unten dokumentierten Standard-Exit-Codes und können für Deployment-Monitoring ausgewertet werden.

Deinstallation unter Windows

1. Öffne Windows-Einstellungen (Tastenkombination Win + I).
2. Navigiere zu Apps → Installierte Apps.
3. Suche in der Liste nach „Kobel".
4. Klicke auf das Drei-Punkte-Menü neben dem Eintrag und wähle Deinstallieren.
5. Bestätige den Vorgang. Kobel wird vollständig entfernt. Deine freigegebenen Ordner und Dateien selbst bleiben davon unberührt.

Wurde Kobel über den Microsoft Store installiert, erfolgt die Deinstallation auf demselben Weg oder alternativ direkt über die Store-App.

Deinstallation unter macOS

1. Öffne das Launchpad, halte das Kobel-Symbol gedrückt und klicke auf das ×.
2. Alternativ ziehst du Kobel im Finder aus dem Ordner „Programme" in den Papierkorb.
3. Optional kannst du danach den Ordner ~/Library/Application Support/Kobel/ löschen. Dort liegen deine lokalen Kobel-Daten: die Liste der freigegebenen Ordner, die verwalteten KI-Anwendungen, das Audit-Log und deine Einstellungen.
4. Deine freigegebenen Ordner und Dateien selbst bleiben davon unberührt.

Installer-Rückgabecodes (nur Windows)

Der Kobel-Installer gibt nach Abschluss einen numerischen Exit-Code zurück. Diese Codes entsprechen den Windows-Standard-Fehlercodes und können für automatisierte Deployment-Szenarien ausgewertet werden.

Support

Bei Fragen zur Installation oder Nutzung:

• Häufige Fragen im FAQ
• Schreib uns an hello@kobel.app
• Weitere Informationen auf kobel.app