Skip to content

Deep link

igardev edited this page Jul 30, 2026 · 2 revisions

Deep links

Overview

Llama-vscode supports deep links. For example, the link vscode://ggml-org.llama-vscode?view=env launches VS Code and shows the env view.
If you use the project parameter with a local folder path in the link, it will open the project. For example, vscode://ggml-org.llama-vscode?project=~/myproject loads the folder ~/myproject in VS Code.

How to use it

Click the link to have VS Code display the requested view and load the specified project folder.
To create a custom link, start with vscode://ggml-org.llama-vscode? and add desired parameters.

Parameters:

Available parameters include view, project, prompt (only applicable when used with view=agent) and filter (only applicable when used with the view=settings).

View parameter accepts these values:

  • env - displays the env view
  • agent - displays the agent view
  • edit-agent - displays the agent editor view
  • menu - displays the Llama-vscode menu
  • chat-with-ai - displays the chat interface (requires a llama.cpp model to be selected for Chat or Tools)
  • settings - displays the Llama-vscode settings (if filter is provided, settings will be filtered by the specified value)

Project parameter accepts a local folder path. Example: vscode://ggml-org.llama-vscode?project=C:/projects/myproject

Prompt accepts text vlaue - it will be used as a prompt for the agent. example: vscode://ggml-org.llama-vscode?view=agent&prompt=Hello.

Filter parameter accepts a text string. Example: vscode://ggml-org.llama-vscode?view=settings&filter=timeout

All parameter values (mainly prompt and filter) should be URL encoded (for example the space character should be encoded as %20).

Clone this wiki locally