Installation

Installation aus dem Marketplace

1. Visual Studio Code 1.102+ öffnen (ältere Versionen laden die Extension nicht).
2. Extensions: Ctrl+Shift+X (macOS: Cmd+Shift+X).
3. Nach AI Keep Clean suchen oder die Marketplace-ID eingeben: ready-4-it.aikeepclean.
4. Installieren klicken.
5. Falls die Activity-Bar oder die Statusleiste nicht sofort erscheint: Befehlspalette (Ctrl+Shift+P) → Developer: Reload Window.

CLI-Alternative (ebenfalls VS Code, nicht Cursor):

code --install-extension ready-4-it.aikeepclean

Nur VS Code ist offiziell getestet. Derivate wie Cursor vor dem Kauf selbst prüfen.

Was nach der Installation sichtbar sein muss

Prüfen Sie nacheinander — das ist die Grundfunktion, noch ohne Lizenzschlüssel:

1. Statusleiste: Eintrag AKC bzw. AKC Free. Ein Klick öffnet ein Terminal im aktuellen Workspace (unter Windows extern PowerShell / Windows Terminal, bereits in den Workspace-Farben). Tutorial: Terminal-Pfade.
2. Activity Bar: AKC-Bereich mit Configure, Help, License.
3. Unter Configure mindestens:
   • Workspace Settings
   • Workspace Presets
   • Indent & Hierarchy Settings
   • Explorer Root Colors
   • AI / KI Settings (optional)
4. Einstellungen: Suche nach AI Keep Clean — Optionen müssen erscheinen, ohne Fehlermeldung in der View.

Online-Guides in der Extension: Help → Online Guides (ready-4-it.com/akc/guides).

Erste sinnvolle Checks (noch ohne Pro)

• In Workspace Settings ein Builtin-Preset previewen und erst danach Apply. Scope auf Workspace vs. Global achten.
• In Explorer Root Colors die ersten beiden Roots einfärben (Free). Ein dritter Root bleibt in Free bewusst ungetintet — das ist kein Bug, siehe Lizenz.
• Dark- und Light-Mode sind getrennte Apply-Ziele. Wenn Farben „falsch“ wirken, prüfen Sie in der Statusleiste, ob Sie ins aktive Mode applied haben.

Typische Installationsfehler

• AKC-View fehlt: Developer: Reload Window. Extension-Host-Cache nach einem Update ebenfalls so leeren.
• Befehl nicht sichtbar / Extension grau: in der Extension-Ansicht auf Enable prüfen; Window neu laden.
• Alte Settings-Pfade: aktuelle Keys liegen unter r4it.ai.shared.* (keine Legacy-Pfade mehr verwenden).
• VS Code zu alt: Engine ist ^1.102.0. Unter 1.102 installiert VS Code die Extension nicht oder deaktiviert sie.
• Falsche Marketplace-ID: ready-4-it.aikeepclean — nicht eine ältere/abweichende ID.
• Antivirus fängt Statusleisten-Klicks ab: code.exe in die Ausschlussliste des Scanners aufnehmen (bekanntes Zertifikat-/Hook-Thema auf manchen Windows-Systemen).

Weiter: Erste Schritte · Voraussetzungen.