Skip to content

Deep link

Jump to bottom
igardev edited this page Jul 31, 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.
It works in a similar was as the mailto: links, which open a mail client.

How to use it

Click the link to have VS Code display the requested view and load the specified project folder. For security reasosons, some platforms don't allow links different than http:// and https:// (for example github links from markdown). Some browsers don't allow deep links for security reasons. You can also open the link from the command line:

Linux:

xdg-open "vscode://ggml-org.llama-vscode?view=env"

Windows PowerShell:

Start-Process "vscode://ggml-org.llama-vscode?view=env"

Windows comd:

start "" "vscode://ggml-org.llama-vscode?view=env"

Mac:

open "vscode://ggml-org.llama-vscode?view=env"

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. Before opening the project, make sure you know this folder to avoid security issues.

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