Caimex AI for VS Code

Your unified AI coding companion — chat, refactor, debug, document, and ship faster, all from inside VS Code.

Caimex AI brings a powerful, multi-provider AI gateway directly into your editor. Whether you're explaining a tricky function, generating tests, reviewing a diff, or scaffolding a whole new module, Caimex keeps you in flow — no copy-pasting into a browser, no context switching.

✨ Why Caimex?

• 🧠 Multi-model, one experience — Talk to Claude, GPT, Mistral, and more through a single, consistent interface.
• 💬 Rich conversational chat — Sidebar chat with streaming responses, code-aware context, and persistent history.
• ⚡ 40+ built-in code actions — Explain, refactor, fix, optimize, document, translate, secure — right-click and go.
• 🔧 Git-aware workflows — Auto-generate commit messages, review staged changes, summarize branches.
• 🤖 Custom assistants — Switch between specialized personas (architect, reviewer, tester, doc-writer) on demand.
• 🪄 Inline completions — Optional ghost-text suggestions powered by fast, low-cost models.
• 🏢 Enterprise-ready — Self-hosted server support, self-signed cert handling, secure API key storage.

🚀 Quick Start

1. Install

• From VSIX (private builds): code --install-extension caimex-ai-0.3.6.vsix
• From Marketplace: search for “Caimex AI” in the VS Code Extensions panel.

2. Sign in

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run:

Caimex: Login

Or, if your organization issued you an API key:

Caimex: Set API Key

3. Open the chat

• Click the Caimex icon in the activity bar, or
• Press Ctrl+Shift+I (Cmd+Shift+I on macOS).

You're ready. Ask anything — Caimex sees your open files, selection, diagnostics, and project context.

🎯 Features at a Glance

💬 Chat with your code

• Streaming sidebar chat with markdown, code blocks, syntax highlighting.
• Workspace-aware context — Caimex can read open files, the current selection, and project metadata.
• Persistent history — your conversations stick around between sessions.
• Multiple assistants — pick a persona that matches the task (e.g. Code Reviewer, Test Author, Architect).

🛠️ Code Actions (right-click any selection)

🔧 Git superpowers

📦 Project tools

• Analyse Codebase — high-level architecture overview.
• Detect Tech Stack — frameworks, languages, build tools.
• Audit Dependencies — outdated, deprecated, or risky packages.
• Scan TODOs & FIXMEs — collect every loose end into a tidy report.
• Generate Boilerplate — components, modules, configs, tests.
• Generate .gitignore — tailored to your detected stack.
• Lint Project / Run Tests — orchestrate from the chat.

⚡ Inline completions (optional)

Enable in settings to get fast ghost-text suggestions while you type. Defaults to a low-cost model so it stays affordable.

// settings.json
"caimex.inlineCompletions.enabled": true,
"caimex.inlineCompletions.model": "mistral-small-latest"

Trigger manually any time with Ctrl+Shift+Space (Cmd+Shift+Space).

⌨️ Keyboard Shortcuts

All shortcuts are remappable via File → Preferences → Keyboard Shortcuts.

⚙️ Configuration

Open VS Code Settings (Ctrl+, / Cmd+,) and search for Caimex — or edit settings.json directly:

💡 Tip: On public networks or trusted CA-signed deployments, set caimex.allowSelfSignedCerts to false for stricter security.

Switching models on the fly

Caimex: Select Model

Pick from the list of models your account has access to. The choice persists across sessions.

Switching assistants

Caimex: Select Assistant

Or use the Assistants view in the Caimex sidebar.

🔐 Privacy & Security

• Your API key is stored in VS Code's secure secret storage — never written to disk in plaintext.
• Code never leaves your machine without an explicit action (chat message, command, or inline completion).
• Self-hosted ready — point caimex.serverUrl at your own Caimex deployment for full data sovereignty.
• Enterprise SSO / API-key auth — works with your organization's existing identity provider.

🧰 Requirements

• VS Code 1.85.0 or later
• A Caimex account or API key (talk to your administrator if you're on an enterprise plan)
• Network access to your configured caimex.serverUrl

🐛 Troubleshooting

📝 Release Notes

See the full changelog in CHANGELOG.md. Highlights from recent releases:

• 0.3.x — Assistants view, Git tools, project analysis suite, expanded code actions.
• 0.2.x — Streaming chat, inline completions, model picker.
• 0.1.x — Initial public release: chat panel, core code actions, auth.

🤝 Feedback & Support

• 🐞 Found a bug? Open an issue with steps to reproduce and the Caimex AI output log.
• 💡 Have an idea? We love feature requests — tell us what would make your day.
• 📧 Enterprise support: contact your Caimex administrator or the Caimex team.

📄 License

See LICENSE.

Author: Lewin Muzvonda | Econet AI

Caimex AI — code at the speed of thought.