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
- Open the
vscode-ginga folder in VS Code.
- Press
F5 to launch an Extension Development Host.
- 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.