Installation

Install from the Marketplace

1. Open Visual Studio Code 1.102+ (older builds will not load the extension).
2. Extensions: Ctrl+Shift+X (macOS: Cmd+Shift+X).
3. Search AI Keep Clean or paste the Marketplace ID: ready-4-it.aikeepclean.
4. Click Install.
5. If the Activity Bar or status bar item does not appear: Command Palette (Ctrl+Shift+P) → Developer: Reload Window.

CLI (VS Code, not Cursor):

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

Only VS Code is officially tested. Check derivatives such as Cursor yourself before buying.

What must be visible after install

Check these in order — this is the baseline, still without a license key:

1. Status bar: AKC / AKC Free. A click opens a terminal in the current workspace (on Windows an external PowerShell / Windows Terminal already tinted). Tutorial: terminal paths.
2. Activity Bar: AKC with Configure, Help, License.
3. Under Configure at least:
   • Workspace Settings
   • Workspace Presets
   • Indent & Hierarchy Settings
   • Explorer Root Colors
   • AI / KI Settings (optional)
4. Settings: search AI Keep Clean — options appear, view loads without an error.

In-extension docs: Help → Online Guides (ready-4-it.com/akc/guides).

First checks (still Free)

• In Workspace Settings, preview a builtin preset, then Apply. Watch Workspace vs Global scope.
• In Explorer Root Colors, tint the first two roots (Free). A third root stays untinted on Free — not a bug; see License.
• Dark and Light are separate apply targets. If colors look “wrong”, match Apply to the active mode (sun/moon in the status bar).

Typical install failures

• AKC view missing: Developer: Reload Window. Do the same after an update (extension host cache).
• Command missing / extension greyed out: Enable it in the Extensions view, then reload.
• Old setting paths: current keys live under r4it.ai.shared.*.
• VS Code too old: engine ^1.102.0. Below 1.102 VS Code will not install or will disable the extension.
• Wrong Marketplace ID: ready-4-it.aikeepclean.
• Antivirus intercepts status-bar clicks: add code.exe to the scanner exclusion list (known cert/hook issue on some Windows setups).

Next: First steps · Prerequisites.