Nimbus for VS Code

Local-first AI agent for the editor. Ask and search against your private Nimbus index — all running on your machine.

Ask — chat with the Nimbus agent in a side panel; responses stream token-by-token.
Search — query your local Nimbus index across every connected service from the command palette.
Selection-aware — right-click a selection to Ask About Selection or Search Selection.

Install

VS Code Marketplace: ext install nimbus-agent.nimbus-vscode
Open VSX (Cursor, VSCodium): ext install nimbus-agent.nimbus-vscode
Manual: download the .vsix from the latest release and run code --install-extension nimbus-<ver>.vsix.

Quickstart

Run Nimbus: Ask from the command palette, or right-click a selection in the editor and choose Ask About Selection / Search Selection. The extension connects to your local Nimbus Gateway automatically (enable nimbus.autoStartGateway to have it start the Gateway for you).

Requires

A running Nimbus Gateway. See https://nimbus-agent.dev/install for setup.

Settings

Setting	Default	What it does
`nimbus.socketPath`	(auto)	Override the Gateway socket path.
`nimbus.autoStartGateway`	`false`	Spawn `nimbus start` if the socket is unreachable.
`nimbus.askAgent`	(Gateway default)	Default agent name passed to Ask.
`nimbus.hitlAlwaysModal`	`false`	Render HITL consent as a blocking modal instead of a toast.
`nimbus.logLevel`	`info`	Output-channel verbosity.

Contributing

See CONTRIBUTING.md. This repository was extracted from the Nimbus monorepo; it consumes @nimbus-dev/client from npm and releases independently of the Gateway.

License

MIT

Nimbus Agent

nimbus-agent