Local AI agent for VS Code — get a Copilot-like coding experience powered entirely by your own machine, with no cloud, no API keys, and no usage limits.
Built on top of Ollama, Snake Agent gives you a full conversational AI agent that can read, create, and edit files, run terminal commands, and manage multi-turn conversations — all from the VS Code sidebar.
Features
Three modes in one panel
| Mode | Behavior |
|---|---|
| Ask | Answers questions about your code without modifying anything |
| Plan | Breaks down tasks into structured steps before acting |
| Agent | Directly creates, edits, and deletes files and runs commands |
Agent executes, not just explains
In Agent mode, Snake Agent uses tools to act on your workspace — it doesn't give you manual instructions. It creates files, edits code, and runs commands with your permission.
Permission system
Every file edit, file read, or terminal command requires your approval. You can set each permission to Always allow, Always deny, or Ask each time.
Edited files panel
After the agent edits files, a collapsible panel appears above the input bar showing exactly which files changed and the diff stats (+N -N). Choose Manter to keep the changes or Desfazer to revert them.
Conversation sessions
All conversations are saved. A home screen lists your sessions so you can pick up where you left off or start fresh.
Runs 100% locally
No data leaves your machine. Uses Ollama to run any locally available model — qwen3:8b, llama3, deepseek-coder, and more.
Requirements
- Ollama installed and running locally (
ollama serve) - At least one model pulled, e.g.:
ollama pull qwen3:8b
Getting Started
- Install the extension from the VS Code Marketplace
- Make sure Ollama is running:
ollama serve - Open the Snake Agent panel from the Activity Bar
- Select your model from the dropdown
- Choose a mode and start chatting
Extension Settings
This extension does not add any VS Code settings. All configuration (model, mode, permissions) is managed directly inside the panel.
Known Issues
- Requires Ollama to be running before opening the panel
- Vision/image context only works with multimodal models (e.g.
llava)
Release Notes
See CHANGELOG.md for the full history.
1.0.0
Initial public release.
License
MIT — see LICENSE for details.
Snake Agent — Português
Agente de IA local para o VS Code — tenha uma experiência similar ao Copilot rodando completamente na sua máquina, sem nuvem, sem chaves de API e sem limites de uso.
Baseado no Ollama, o Snake Agent é um agente de IA conversacional completo que lê, cria e edita arquivos, executa comandos no terminal e gerencia conversas com histórico — tudo pela barra lateral do VS Code.
Funcionalidades
Três modos em um painel
| Modo | Comportamento |
|---|---|
| Ask | Responde perguntas sobre o código sem modificar nada |
| Plan | Divide tarefas em etapas estruturadas antes de agir |
| Agent | Cria, edita e deleta arquivos e executa comandos diretamente |
O agente age, não só explica
No modo Agent, o Snake Agent usa ferramentas para atuar no seu workspace — ele não te dá instruções manuais. Cria arquivos, edita código e roda comandos com a sua permissão.
Sistema de permissões
Cada edição de arquivo, leitura ou comando no terminal requer sua aprovação. Cada permissão pode ser configurada como Sempre permitir, Sempre negar ou Perguntar sempre.
Painel de arquivos editados
Após o agente editar arquivos, um painel recolhível aparece acima da barra de entrada mostrando exatamente quais arquivos foram alterados e as estatísticas do diff (+N -N). Escolha Manter para aceitar as mudanças ou Desfazer para revertê-las.
Sessões de conversa
Todas as conversas são salvas. Uma tela inicial lista suas sessões para você continuar de onde parou ou começar do zero.
100% local
Nenhum dado sai da sua máquina. Usa o Ollama para rodar qualquer modelo instalado localmente — qwen3:8b, llama3, deepseek-coder e outros.
Requisitos
- Ollama instalado e rodando localmente (
ollama serve) - Pelo menos um modelo baixado, ex.:
ollama pull qwen3:8b
Como começar
- Instale a extensão pelo VS Code Marketplace
- Certifique-se de que o Ollama está rodando:
ollama serve - Abra o painel Snake Agent na barra de atividades
- Selecione o modelo no seletor
- Escolha o modo e comece a conversar
Configurações
Esta extensão não adiciona configurações ao VS Code. Toda a configuração (modelo, modo, permissões) é gerenciada diretamente dentro do painel.
Problemas conhecidos
- O Ollama precisa estar rodando antes de abrir o painel
- Contexto de imagem/visão funciona apenas com modelos multimodais (ex.:
llava)
Licença
MIT — veja LICENSE para detalhes.
Following extension guidelines
Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.
Working with Markdown
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
- Split the editor (
Cmd+\on macOS orCtrl+\on Windows and Linux). - Toggle preview (
Shift+Cmd+Von macOS orShift+Ctrl+Von Windows and Linux). - Press
Ctrl+Space(Windows, Linux, macOS) to see a list of Markdown snippets.
For more information
Enjoy!