Meraby AI
A free AI coding assistant for VS Code — bring your own API key.
Chat, an approval-gated coding agent, prompt tools, code explanations, test and commit-message generation.
Alpha: Meraby AI is in active alpha. Some features may be incomplete or unstable while we iterate.

✨ Free, bring your own key
Meraby AI is free. There is no Meraby account, no sign-in and no usage tracking.
- 🔑 Your key, your provider. Use your own API key for Google Gemini, OpenAI or Anthropic, or run fully local with any OpenAI-compatible server such as Ollama, LM Studio or vLLM.
- ➡️ Requests go straight to your provider. Every AI request is sent directly from VS Code on your machine to the provider you choose. There is no Meraby server in between.
- 🙈 Meraby Labs never receives your code, prompts or keys. The extension does not contact any Meraby Labs server and sends no telemetry.
- 🔒 Keys stay in VS Code Secret Storage (your OS keychain). They are never written to settings files or to disk in plain text, and they are never shown in the chat panel.
You pay your provider directly under your own plan (many providers, including Gemini, have a free tier). Local models through Ollama cost nothing.
⚡ Setup
- Install Meraby AI from the VS Code Marketplace.
- Get an API key from your provider:
- Run
Meraby: Set API Key from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P). You can also click the key item in the status bar, or Set API Key in the Meraby AI panel. Pick your provider, then paste your key (or enter the base URL for an OpenAI-compatible server).
- (Optional) Choose a model in Settings → Meraby AI → Model (
meraby.model). If you leave it empty, the provider's default is used.
- Open the Meraby AI icon in the Activity Bar and start chatting.
To remove a stored key, run Meraby: Clear API Key.
🎯 Features
💬 AI Chat
Ask questions, generate code and get refactoring help in the sidebar chat. Responses stream in real time.
🤖 Coding agent (with approval)
The agent can use a small set of local tools on your workspace: read, list and search files, write files, run git, npm scripts and commands.
- Read-only tools (read, list or search files inside the workspace) run automatically.
- Every tool that changes something (writing a file, running a command, git, npm or terminal) asks for your approval first and shows a diff or command preview.
- All file tools are confined to the open workspace folder. Absolute paths,
.. and symlinks that escape the workspace are rejected.
- Commands run without a shell. Pipes,
;, &&, redirects, $(...) and backticks are rejected, and shells, sudo, rm, curl and similar programs are blocked.
Generate, refine and analyze prompts with templates for coding, writing, research, analysis and fact-checking.
Explain a selection, generate tests, generate a conventional commit message from your staged diff, and transform code inline.
📎 Context, ⚙️ Automations and 📝 Notes
Pin context files, run detected project scripts, and keep project notes. These features work locally.
🎹 Keyboard Shortcuts
| Action |
Windows/Linux |
Mac |
| Open Chat |
Ctrl+Shift+D |
Cmd+Shift+D |
| Open Meraby AI Panel |
Ctrl+Shift+H |
Cmd+Shift+H |
| Index Workspace |
Ctrl+Shift+I |
Cmd+Shift+I |
| Generate Prompt |
Ctrl+Shift+G |
Cmd+Shift+G |
| Refine Selection |
Ctrl+Shift+R |
Cmd+Shift+R |
| Analyze Prompt |
Ctrl+Shift+A |
Cmd+Shift+A |
| Explain Selection |
Ctrl+Shift+E |
Cmd+Shift+E |
| Generate Tests |
Ctrl+Shift+T |
Cmd+Shift+T |
| Generate Commit Message |
Ctrl+Alt+C |
Cmd+Alt+C |
🔧 Commands
Commands are available from the Command Palette (Ctrl+Shift+P):
| Command |
Description |
Meraby: Set API Key |
Choose a provider and store your API key in Secret Storage |
Meraby: Clear API Key |
Delete a stored API key |
Meraby: Open Chat |
Open the AI chat |
Meraby: Start Autonomous Agent |
Run the approval-gated coding agent on a task |
Meraby: Plan Implementation |
Plan a complex task |
Meraby: Index Workspace |
Index workspace files locally for context |
Meraby: Generate Prompt |
Create an optimized prompt |
Meraby: Explain Selection |
Explain the selected code |
Meraby: Generate Tests |
Generate tests for the selected code |
Meraby: Generate Commit Message |
Write a commit message for staged changes |
⚙️ Settings
| Setting |
Default |
Description |
meraby.provider |
gemini |
AI provider: gemini, openai, anthropic or openai-compatible. Machine-scoped, so a workspace cannot change it. |
meraby.model |
(empty) |
Model name. Empty uses the provider default: gemini-2.5-flash, gpt-4o-mini, claude-sonnet-4-5, or llama3.1 for OpenAI-compatible. Machine-scoped. |
meraby.baseUrl |
(empty → http://localhost:11434/v1) |
Base URL for openai-compatible only. Ignored for the other providers, which always use their official endpoints. Machine-scoped. |
meraby.requestTimeoutSeconds |
120 |
Timeout for one AI request (10–600 seconds). |
meraby.defaultSpell |
general |
Default prompt template: coding, writing, research, analysis, factcheck or general. |
meraby.targetModel |
general |
Model family that generated prompts are optimized for (gpt-4, claude, gemini, general). |
meraby.showPresence |
true |
Show the Meraby AI item in the status bar. |
meraby.useRealmContext |
true |
Allow workspace files to be used as context. |
meraby.autoIndexRealm |
true |
Prompt to index the workspace when needed. |
meraby.enableStreaming |
true |
Stream AI responses. |
meraby.autoInjectContext |
true |
Add workspace context to agent requests automatically. |
meraby.proactiveRefine |
false |
Show proactive prompt-refinement suggestions. |
meraby.maxAgentSteps |
10 |
Maximum number of agent steps per task (1–50). |
meraby.codeLens.enabled |
true |
Show Explain / Improve / Test hints above functions and classes. |
API keys are not settings. They are stored only in VS Code Secret Storage through Meraby: Set API Key.
🔒 Privacy & Security
- What leaves your machine: only the requests you trigger (your prompt, plus any selected code, workspace context or tool results that feature needs). They go directly to the provider you configured, under that provider's own terms and privacy policy. For a local OpenAI-compatible server, nothing leaves your machine.
- What Meraby Labs receives: nothing. There is no Meraby backend, account, sign-in or telemetry. Meraby Labs never receives your code, prompts or keys.
- Keys: stored in VS Code Secret Storage, sent only to the matching provider, and removed from error messages.
- Agent safety: workspace-confined file access, approval for every change, no shell for commands, and a strict Content Security Policy in every webview.
🤝 Support
📄 License
Proprietary © Meraby Labs. All Rights Reserved.
| |