What AKC is for
AI Keep Clean is a workspace design and structure tool for Visual Studio Code. The point is to see which project is open in a glance — and to keep nested code readable.
As of v1.22.41 that includes:
- Workspace colors: status bar, title bar, side bars (optionally editor/panel) per workspace.
- Status-bar terminal: click
AKCin the status bar to open a terminal already in the workspace path and those colors (on Windows typically PowerShell / Windows Terminal). - Explorer Root Colors: tinted workspace roots in Explorer. Free: first 2 roots with builtin palettes; root 3+ and custom hex need Trial/Pro.
- Indent & hierarchy guides: rainbow indent and hierarchy overlays.
- Workspace presets & tinted: builtin presets, custom presets, import from the validated tinted catalog (up to 250 themes). Preset collection import/export from Trial/Pro.
- Theme Suggest & Colour Zen: offline vibe-catalog suggestions; optional local Ollama seeds. Colour Zen checks contrast before Apply.
- AI Compare (file/folder): convenience feature, not core — Trial/Pro only.
You can use AKC without any AI. AI is optional.
Technical requirements
| Component | Minimum | Recommended |
|---|---|---|
| VS Code | 1.102+ | current Stable |
| OS | Windows, macOS, Linux (64-bit) | Windows if you want the external tinted terminal |
| Workspace | folder or multi-root .code-workspace |
multi-root when Explorer Root Colors matter |
| Internet | only for cloud AI, Marketplace install, and license activation | stable access for Trial/Pro activation |
Visual Studio Code is what we test. Derivatives (e.g. Cursor) should be verified before purchase — official support is VS Code only.
Marketplace ID: ready-4-it.aikeepclean
AI requirements (optional)
Theme Suggest works offline from the vibe/preset catalog. You need Ollama only if you enable Generate with local model for seed colors. AI Compare always uses the configured provider.
Option A: local Ollama
- Ollama installed and running (
ollama serve) - a pulled model, e.g.
ollama pull llama3 - endpoint reachable (default
http://localhost:11434) - same base URL under Configure → AI / KI Settings
Option B: OpenAI-compatible service
- API endpoint and API key
- a suitable model
- only needed for cloud suggestions or AI Compare — not for workspace colors, terminal, or root colors
Free: 10 AI suggestions per local day. Trial/Pro: unlimited.
License requirements (short)
- Free: no activation. Limits include 1 custom preset, 25 workspaces, Explorer tint on the first 2 roots only, no preset export/import, no AI Compare.
- Trial (14 days): token required. Unlocks 3+ roots, custom hex, import/export, AI Compare, unlimited suggestions (2 device activations).
- Pro: the same expanded set permanently (e.g. 150 custom presets, unlimited workspaces, 2 activations).
Details: License. Install: Installation.