Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>GingaNew to Visual Studio Code? Get it now.
Ginga

Ginga

Alexandre E Souza

| (0) | Free
VS Code extension that connects to the Ginga CLI through the ACP stdio JSON-RPC server.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Ginga for VS Code

VS Code extension for the Ginga CLI. It starts the installed ginga binary as an ACP stdio JSON-RPC server and exposes a Ginga Code editor chat, a sidebar history/composer, and command palette actions.

Requirements

  • Ginga installed and available in PATH, or configured through ginga.executablePath.
  • API credentials: type the key in Ginga: Configure Settings. Each provider has its own key, kept in VS Code's secret storage, and only the selected provider's key is given to the agent. Environment variables and .env work too.
  • A model: set ginga.model, or leave it empty to use the one saved with ginga config set model <provider:model>.

Run Locally

  1. Open the vscode-ginga folder in VS Code.
  2. Press F5 to launch an Extension Development Host.
  3. Run Ginga Code from the command palette or click the Ginga editor title action.

No compile step is required; the extension is plain JavaScript.

Commands

  • Ginga Code
  • Ginga: New Chat
  • Ginga: Ask About Selection
  • Ginga: Run Deep Task
  • Ginga: Show Status
  • Ginga: Restart ACP Server
  • Ginga: Review Changes
  • Ginga: Keep Changes
  • Ginga: Revert Changes

How it works with your files

  • Editor context. Each message carries the active file and, when there is one, the selected lines, so "explain this" or "fix this function" work without pasting code. Turn it off with ginga.includeEditorContext.
  • Review and revert. When the agent writes files, the extension keeps what each file looked like before. After the turn it lists the changed files and offers Ver diferenças (a diff of before and after), Reverter tudo or Manter. The same actions are in the editor title bar while there are changes to review. Binary files and files over 512 KB are listed but cannot be diffed or reverted.
  • Stop. The stop button ends the agent process, so nothing keeps running in the background. The next message starts a new one.
  • Database changes. A command that changes data in a database (INSERT, UPDATE, DELETE, migrations and the like) opens a modal dialog showing the exact command. Only the Executar button runs it; closing the dialog blocks it.
  • Long tasks. ginga.requestTimeoutMs counts silence, not total time: every tool call or progress step restarts it.

Settings

The custom settings panel exposes provider and model lists, including OpenAI, Anthropic, OpenRouter, Ollama, Azure OpenAI, Google Gemini, and custom provider/model values.

{
  "ginga.executablePath": "ginga",
  "ginga.model": "openai:gpt-4o",
  "ginga.workspace": "",
  "ginga.extraArgs": [],
  "ginga.environment": {}
}

The extension launches:

ginga --workspace <workspace> [--model <model>] acp --name vscode-ginga --protocol-version 1

Make Targets

Install @vscode/vsce if needed, then use the local Makefile:

make package
make publish
make publish-vsix

make publish publishes directly from the manifest. make publish-vsix generates the .vsix first and publishes that exact package.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft