VibeFree

An agentic AI coding assistant that lives in your editor.

VibeFree is a VS Code extension that puts a full agentic coding assistant in a side panel next to your code. It doesn't just answer questions - it reads and edits files, runs terminal commands, searches your workspace, and can call out to your configured MCP servers, all while keeping you in control of anything that happens outside your project.

Features

• Chat panel, right next to your code - opens as a webview beside the active editor, so you can keep the conversation and the file you're discussing on screen together.
• Agentic file editing - the assistant can create files, apply single or multi-location edits, and open the changed file for you automatically. Every edit shows an inline diff (added/removed line counts) before you move on.
• One-click rewind - every turn in the conversation is checkpointed. Roll back to an earlier point in the chat and VibeFree restores the files it touched to their prior state.
• Workspace-aware tools - list directories, glob for files, and run git grep-backed searches scoped to your project.
• Terminal command execution - run commands in the background, poll their status, stream output, or send input to a still-running process, all from the chat.
• Scheduling - ask VibeFree to remind you or re-trigger a prompt after a delay, or on a cron schedule, without leaving the editor.
• MCP integration - connects to Model Context Protocol servers defined in your local Gemini CLI config, so existing MCP tools and resources are available inside the chat.
• Built-in task tracking - the assistant can plan multi-step work as a visible task list in the panel, checked off as it progresses.
• Interactive clarifying questions - when the assistant needs a decision from you, it asks inline via a quick-pick UI instead of guessing.
• Path permission prompts - file and command access outside your workspace requires explicit approval (once, for the session, or always), so the assistant can't silently touch files elsewhere on disk.
• Chat history - recent conversations are saved and can be reopened from the panel; nothing is lost when you switch context.
• Syntax-highlighted responses - code blocks render with language detection and a one-click copy button.

Getting started

1. Install the extension.
2. Run the VibeFree command (via the editor title bar icon or the Command Palette) to open the chat panel.
3. Sign in when prompted to activate your account.
4. Start chatting - ask VibeFree to explain code, make changes, run tests, or investigate an issue.

Requirements

• VS Code 1.74.0 or later.
• A VibeFree account (sign-in is handled from within the panel).
• Optional: an MCP configuration at ~/.vibefree/mcp_config.json if you want VibeFree to use your existing MCP servers. You can also customize this location with the vibefree.mcpConfigPath setting.

Privacy & permissions

VibeFree only operates inside your current workspace by default. If a tool call needs to read, write, or run something outside the workspace folder, you'll be asked to approve it — once, for the rest of the session, or permanently for that path.

Known limitations

This is an early release. Model switching (additional model options beyond the current default) is on the roadmap but not yet available.

Release Notes

1.0.0

Initial release of VibeFree.