Common questions

Two components: ContextMint Engine (desktop app) and the ContextMint VS Code extension. Engine runs the Python server and Ollama; the extension is the chat and governance UI. See getting started and features (v1.0).

On the default local-first path, indexing, embeddings, retrieval, and inference run on your infrastructure via Ollama — source is not required to leave your device. If you opt in to BYOK cloud routing, only redacted assembled context is sent to a provider you choose; API keys stay in VS Code secrets and never pass through Engine. See Trust & Security.

Engine owns process lifecycle: server, Ollama, indexing operations, logs, and settings. ContextMint connects to localhost:8000, shows chat, Context Lens, quality map, and assisted actions — it does not spawn the server in packaged mode.

Local-first (default): open ContextMint Engine from the tray and use Start all. The extension probes health on loopback; if Engine is stopped, chat is gated until the backend is healthy again.

Shared on-prem server: confirm ContextMint.serverUrl points at your team API host, HTTPS/TLS is valid, and enterpriseMode + OIDC are configured if auth is enabled on the server. The extension does not install or start Engine in remote mode.

Yes — use the compose Context selector. Repo (default) answers only from your indexed codebase. Work is for planning, comms, and concepts using session packs and attachments without a repo file search. Hybrid combines repo evidence with reasoned recommendations. ContextMint is not a generic ChatGPT replacement; lanes keep repo answers trustworthy.

Chat is not blocked during background indexing — answers use whatever is indexed so far and improve as files finish. The readiness card may show an indexing banner; you can still send messages. If chat is fully blocked, check for server offline or index error state in Engine → Health.

Yes for local model inference. Engine’s first-run wizard detects Ollama and links to install if missing. If Ollama is offline, repo search may still work but AI generation runs in a degraded limited mode.

Context Lens is the pre-send preview: retrieved chunks, relevance scores, routing choice, and optional governance notes — so you approve evidence before the model runs. It is gate 1 in the human-in-the-loop workflow. See Context Lens & packs.

In chat compose, Ask scopes the model to answer your question, Plan asks for a structured plan before changes, and Agent allows broader multi-step assistance — still with Context Lens (gate 1) and patch preview (gate 2) before repo writes. Pair modes with Repo / Work / Hybrid lanes for where evidence comes from. See Chat, modes & lanes and Features (v1.0).

Assisted actions propose unified diffs; patch preview is gate 2 — you review and confirm before anything applies to your repo. Quality-map clone signals can block apply on high-severity findings when configured. No silent writes. See Patches & governance.

The quality map is stored governance findings from your repo at index time — clone pairs, near-duplicates, and structure signals. Chat can answer from this Findings Store (lookup) instead of rediscovering issues at question time. Inform-only by default; optional gates can block assisted apply. Run scans from the extension or Engine → Quality. See Knowledge & governance.

Context packs are per-repo knowledge bundles (manifest.yaml plus markdown). Activate with @pack:name in chat; the pack panel lists, builds, and auto-syncs when sources change. Packs feed Work and Hybrid lanes and appear in Context Lens before send. See Context Lens & packs.

Yes. ContextMint is a local AI coding assistant in VS Code: Ask, Plan, and Agent, plus inline completion and in-editor review. It runs on your machine by default. A team can also review evidence in Context Lens and approve patches before anything writes.

Solo developer: install Engine and the extension on one machine. Frictionless by default. Turn on controlled checks when you want evidence review and patch approval. Optional bring-your-own-key cloud stays off until you turn it on. No signup, shared server, or SSO. Start at Getting started.

Small company or enterprise: everything in the solo path, plus a shared on-prem server, SSO, operator audit, and an admin lock so a developer cannot change posture or cloud. Talk to us.

ContextMint includes inline completion and also works as a full coding assistant: Ask, Plan, and Agent over your indexed workspace. Context Lens shows the evidence, and patch preview waits for approval before writes.

Yes — for enterprise pilots with platform engineering support. Deploy the API server stack (Docker Compose or Helm) on your infrastructure. Developers set ContextMint.serverUrl to that host and enable enterpriseMode for OIDC Bearer auth. The server must be able to read the workspace path being indexed — typically via VS Code Remote SSH, a mounted monorepo, or a dev VM where code and API run on the same host.

This is not the Engine desktop app (tray console is local-only). A laptop with a local-only clone cannot index through a remote server URL unless paths align. See Trust & Security → Deployment models.

ContextMint Engine is the per-machine operator console: tray app, first-run wizard, Ollama lifecycle, logs, and settings. It runs the API on loopback for individual developers — this is the v1.0 default.

A team API server is the same Python backend packaged for Docker/Kubernetes on customer infrastructure — shared Ollama, Chroma index, Redis rate limiting, and SSO. The extension becomes a thin client pointed at serverUrl. Ops owns deploy, mounts, and auth — not the Engine installer.

Yes — optional and off by default. Enable cloud routing in extension settings, store provider keys in VS Code secrets (OS keychain), and the extension streams directly to approved providers such as OpenAI, Anthropic, or Groq. Keys never pass through the Python engine. Assembled context is redacted before any cloud dispatch. The default path remains local Ollama on your infrastructure. See Trust & Security.

Yes. Paste, drag-drop, or pick PNG, JPEG, or WebP images in the compose bar and ask questions about what you see. ContextMint previews images in Context Lens and routes through a local Ollama vision model by default — no cloud API key required. Optional BYOK cloud vision is available when you explicitly select a vision model.

See Image evidence & ARGUS.

ARGUS is ContextMint’s structured visual audit on UI screenshots. From Context Lens, click Run visual audit to get severity-tagged findings (including WCAG references). ARGUS is report only — it never auto-fixes your repo. You can hand off to patch preview if you choose to act on a finding.

Sandbox audits (Playwright capture in preview worktree) are available when git sandbox is enabled.

Coming soon: local Engine + extension — Ask/Plan/Agent, inline completion, in-editor review, Context Lens, Repo/Work/Hybrid lanes, quality map, image evidence, ARGUS, context packs, patch preview, and symbol-aware citations. Full list.

Later: v2.0 Engineering Intelligence Platform (Q1 2027), Track B enterprise knowledge and compliance (end 2027), and the long-term Verification Engine direction (PR gates, blast radius, drift) — full roadmap.

ContextMint is coming soon. A solo developer follows Getting started. A small company or enterprise books a walkthrough via Talk to us. Paths are also on Early access. Questions go to Support or GitHub issues.

Visit Support and open an issue on the release channel: https://github.com/contextmint/contextmint/issues. You can also email anis@contextmint.ai.