VS Code reference

A lookup table for the nnumbers.imaginne extension. For the step-by-step, see Use in VS Code. Open the chat with Ctrl/Cmd+Shift+I.

Commands (the "Imaginne:" category)

Accessible from the command palette (Ctrl/Cmd+Shift+P) by typing Imaginne:.

Command	What it does
Start	Starts the session.
Open Chat	Opens the chat panel.
Ask Selection	Asks about the selection.
Fix Selection	Fixes the selection.
Explain Selection	Explains the selection.
Refactor Selection	Refactors the selection.
Explain File	Explains the active file.
Generate Tests	Generates tests.
Run Test for File	Runs the file's tests.
Run Test at Cursor	Runs the test at the cursor.
Review Current Changes	Reviews the unstaged changes.
Review Staged Changes	Reviews the staged changes.
Review Branch vs Base	Reviews the branch against the base.
Review File	Reviews the file.
Generate Commit Message	Generates the commit message.
Explain Diff	Explains the diff.
Pin Active File	Pins the active file into the context.
Pin Selection	Pins the selection into the context.
Unpin Context	Removes a pinned item.
Show Pinned Context	Shows what is pinned.
Clear Pinned Context	Clears the pinned items.
Preview Context	Previews the context that will be attached.
Start Agent Task	Starts an agent task.
Stop Agent Task	Stops the task.
Resume Agent Task	Resumes the task.
Run Health Check	Diagnoses the connection.
Login	Logs in via the browser.
Logout	Logs out.
Whoami	Shows the identity.
Configure Binary Path	Sets the path to the imaginne binary.
Open Terminal Session	Opens a session in the terminal.

The extension exposes around 50 commands

The table above covers the ones for direct use. The rest are variations and internal entries that appear in the palette under the same Imaginne: prefix.

Keyboard shortcuts

Shortcut	Action
Ctrl/Cmd+Shift+I	Open the chat.
Ctrl/Cmd+Shift+L	Focus the input field.
Ctrl/Cmd+L	Clear the chat.
Esc	Cancel the execution (with the side bar visible).

Context menus

Where	Items
Editor (right-click)	Ask / Fix / Explain / Refactor Selection; Run Test at Cursor.
Explorer (right-click on a file)	Review File; Run Test for File.
SCM (source control)	Review Current Changes; Review Staged Changes; Generate Commit Message.

Slash commands (in the chat)

Command	Effect
/clear	Clears the chat.
/new	New conversation.
/status	Current state.
/compact	Compacts the context.
/model	Shows the active model (the extension has no picker).
/cancel	Cancels the execution.
/help	Help.
/autonomy	Adjusts the level (Ask / Fix / Agent / Bypass).
/login	Logs in.
/logout	Logs out.
/whoami	Shows the identity.

Directives

Directive	Effect
/fix	Fixes the target in the context.
/explain	Explains.
/test	Generates/runs tests.
/refactor	Refactors.
/review	Reviews.
/plan	Plans before acting.

The @file mention injects the file's content into the context.

Useful settings

The extension exposes around 23 settings (prefix imaginne.). The most used:

Setting	Default	Effect
imaginne.binaryPath	—	The path to the imaginne CLI (if not on the PATH).
imaginne.platformUrl	—	The Imaginne platform URL (advanced).
imaginne.context.smart	true	Turns on smart context.
imaginne.context.includeGitDiff	false	Attaches the git diff.
imaginne.context.includeDiagnostics	true	Attaches diagnostics.
imaginne.context.includeOpenTabs	true	Attaches the open tabs.
imaginne.autonomy.defaultLevel	fix	The initial autonomy level.
imaginne.autonomy.allowApplyAll	true	Allows "Apply All".
imaginne.autonomy.requireConfirmationForDestructive	true	Confirms destructive operations.
imaginne.autonomy.commandAllowlist	—	Commands allowed without confirmation.
imaginne.autonomy.commandDenylist	—	Commands always blocked.
imaginne.autonomy.bypassTimeoutMinutes	30	The expiry of Bypass mode.
imaginne.extraArgs	—	Extra arguments for imaginne serve.

Prerequisite

The extension brings up the imaginne serve CLI underneath. Install the imaginne binary first (see Install the TUI). The DEV channel is the nnumbers.imaginne-dev extension.