Skip to main content
Offline Mode runs MoxyCode entirely on your machine using Ollama — a local AI runtime. No code is sent to any external service. This makes it ideal for restricted environments, air-gapped networks, or developers who require complete data sovereignty.
Offline Mode requires a Pro plan. Running MoxyCode: Set Up Offline Mode on a Free plan will show an upgrade prompt.

​
Requirements

PlanPro
RAM4GB minimum (8GB recommended, 16GB for best quality)
Disk space1GB minimum (up to 9GB depending on model chosen)
OSmacOS or Windows

​
Setup

Run the guided setup from the Command Palette: MoxyCode: Set Up Offline Mode The setup wizard opens and checks your system automatically.

​
Step 1 — System check

MoxyCode scans your machine and shows your available RAM, free disk space, and Ollama status. The wizard handles three scenarios automatically: Ollama not installed: Ollama will be installed automatically during setup. Choose the AI model that best matches your hardware. Ollama installed, compatible model found: MoxyCode detects your existing model and proceeds directly to configuration. Click Configure MoxyCode to continue. Ollama installed, no compatible model: MoxyCode detects Ollama but no suitable model. Choose a model to download and click Set Up Offline Mode. When choosing a model, select based on your available RAM:
ModelQualityDownload sizeRAM required
Qwen 2.5 Coder 14BBest9GB16GB
Qwen 2.5 Coder 7BGreat4.7GB8GB
Qwen 2.5 Coder 1.5BLightweight1GB4GB
MoxyCode automatically selects the recommended model based on your available RAM.
Any Ollama model works with MoxyCode — the options above are our recommendations for Salesforce development. To use a different model, install it via terminal first with ollama pull <your-model-name>, then run the setup wizard.
MoxyCode Offline Mode setup — fresh install system check
MoxyCode Offline Mode setup — existing Ollama detected

​
Step 2 — Installation and download

MoxyCode handles everything automatically with a live progress screen:
  • Installing Ollama — installs the local AI runtime (skipped if already installed)
  • Downloading AI model — downloads your selected model with a live progress percentage
  • Configuring MoxyCode — connects MoxyCode to the local model
MoxyCode Offline Mode setup — progress screen
The 14B model is ~9GB and may take several minutes to over 30 minutes to download depending on your internet speed. Keep VS Code open during the download.

​
Step 3 — Complete

Once setup is complete, MoxyCode shows Offline Mode Ready!
  • Click Switch to Offline Mode to start using offline AI immediately
  • Click Stay Online to keep using online mode and switch later
MoxyCode Offline Mode Ready screen
Once setup is complete, Ollama starts automatically on login. You don’t need to do anything to keep it running.
The local setup (Ollama and the AI model) stays on your machine even if you uninstall MoxyCode. Use MoxyCode: Clean Up Offline Files to remove it when no longer needed.

​
Switching between Online and Offline

Once Offline Mode is set up, switch between modes instantly from the Command Palette: MoxyCode: Toggle Online / Offline Mode
  • Switching to Offline shows: “MoxyCode: Switched to Offline Mode — using local Ollama model”
  • Switching to Online shows: “MoxyCode: Switched to Online Mode — using cloud AI”
The mode persists across sessions — MoxyCode remembers your last setting. Alternatively, switch via VS Code Settings (Cmd+, / Ctrl+,) — search for moxycode and change the MoxyCode: Mode dropdown between online and offline.
MoxyCode switched to Offline Mode notification

​
Removing Offline Mode

Run the cleanup command from the Command Palette: MoxyCode: Clean Up Offline Files A confirmation dialog appears asking what you want to remove.

​
Remove model only

Removes the AI model (~9GB freed) but keeps Ollama on your machine. Choose this if you use Ollama for other tools or projects. Result:
  • ✅ AI model removed (freed ~9 GB)
  • Ollama kept — still available for other tools

​
Remove model + Ollama

Removes both the AI model and Ollama from your machine completely.
  1. First confirmation — lists the AI model to be removed and warns that other applications using Ollama will be affected. Click Remove model + Ollama to continue.
  2. Second confirmation — confirms Ollama removal specifically. You may be prompted for your system password — this is expected when uninstalling system applications.
  3. Cleanup complete — AI model removed and Ollama removed.
Result:
  • ✅ AI model removed (freed ~9 GB)
  • ✅ Ollama removed
Only remove Ollama if you no longer need local AI on this machine. Removing Ollama will disable offline AI features for MoxyCode and any other applications that use it.
MoxyCode Clean Up Offline Files confirmation dialog

​
Common issues

Offline Mode requires a Pro plan. Upgrade at moxycode.com to access Offline Mode.
The recommended 14B model requires ~9GB of free disk space. If you don’t have enough space:
  • Choose the 7B model (4.7GB) or 1.5B Lite model (1GB) during setup
  • Free up disk space and run MoxyCode: Set Up Offline Mode again
The model download requires a stable internet connection. If the download stalls:
  1. Keep VS Code open and wait — the download resumes automatically in most cases
  2. If it appears stuck for more than 10 minutes, close VS Code and run MoxyCode: Set Up Offline Mode again — the wizard will detect the partial download and resume
Run MoxyCode: Set Up Offline Mode again — Ollama may not have been running when the wizard first scanned. The wizard will detect it on the next scan.
  1. Check that MoxyCode: Mode is set to offline in VS Code Settings (Cmd+, / Ctrl+,)
  2. Run Developer: Reload Window from the Command Palette and try again
  3. If the issue persists, run MoxyCode: Clean Up Offline Files and set up again
Yes — removing Ollama requires system-level permissions. The password prompt is expected when uninstalling system applications. Enter your login password to proceed.
The local setup (Ollama and the AI model) persists after uninstalling MoxyCode, and Ollama will continue to auto-start on login. To remove it completely:
  1. Reinstall MoxyCode from the VS Code Marketplace
  2. Run MoxyCode: Clean Up Offline Files and choose Remove model + Ollama
  3. Uninstall MoxyCode again
If the cleanup wizard fails, you can remove the model and Ollama manually via terminal.List all installed models first:
  ollama list
Remove your model (replace <model-name> with the name from the list above):
  ollama rm <model-name>
Uninstall Ollama on Mac:
  # Stop Ollama
  killall ollama

  # Remove the application
  rm -rf /Applications/Ollama.app

  # Remove models and data
  rm -rf ~/.ollama
Uninstall Ollama on Windows:
  # Uninstall via Windows Settings → Apps → Ollama
  # Then remove model data
  rmdir /s /q %USERPROFILE%\.ollama

Safe Mode

Control when fixes are applied to your code

Privacy & FAQ

How MoxyCode handles your code and data in offline mode