Installation

There are several ways to install Quarto Wizard in Visual Studio Code or Positron.

VS Code Marketplace / Open VSX

The easiest way to install Quarto Wizard:

  1. Open Visual Studio Code or Positron.
  2. Go to the Extensions view (Ctrl+Shift+X or Cmd+Shift+X on macOS).
  3. Search for “Quarto Wizard”.
  4. Click Install on the extension.

The Extensions view showing Quarto Wizard in the search results with the Install button. The Extensions view showing Quarto Wizard in the search results with the Install button.

Command Line

You can also install via the command line:

Terminal
code --install-extension mcanouil.quarto-wizard

Via VS Code Marketplace.

Terminal
positron --install-extension mcanouil.quarto-wizard

Via Open VSX.

Manual Installation

For manual installation from a GitHub release:

  1. Download the latest .vsix file from the GitHub Releases.
  2. In VS Code, open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
  3. Run Extensions: Install from VSIX....
  4. Select the downloaded .vsix file.

Using GitHub CLI

You can download, verify attestation, and install in one go using the GitHub CLI.

Terminal
gh release download "2.0.0" --repo mcanouil/quarto-wizard --pattern "*.vsix"
gh attestation verify "quarto-wizard-2.0.0.vsix" --repo mcanouil/quarto-wizard
code --install-extension mcanouil.quarto-wizard

Via GitHub Release.

Terminal
gh release download "2.0.0" --repo mcanouil/quarto-wizard --pattern "*.vsix"
gh attestation verify "quarto-wizard-2.0.0.vsix" --repo mcanouil/quarto-wizard
positron --install-extension mcanouil.quarto-wizard

Via GitHub Release.

Verifying Installation

After installation, you can verify it worked by:

  1. Opening the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
  2. Typing “Quarto Wizard”.
  3. You should see the available Quarto Wizard commands.

The Command Palette showing Quarto Wizard commands ready to use. The Command Palette showing Quarto Wizard commands ready to use.

System Requirements

Visual Studio Code

  • VS Code version 1.96.0 or later.
  • Alternatively, Positron IDE is also supported.

Internet Connection

An active internet connection is required for:

  • Fetching the extension registry.
  • Downloading and installing extensions from GitHub.
  • Checking for extension updates.

Optional: GitHub Authentication

For accessing private repositories or avoiding rate limits, you can configure GitHub authentication:

  1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
  2. Run Quarto Wizard: Set GitHub Token (Manual).
  3. Enter your GitHub personal access token.

The input dialog for entering a GitHub personal access token. The input dialog for entering a GitHub personal access token.

Alternatively, Quarto Wizard can use:

  • VS Code’s built-in GitHub authentication.
  • Environment variables (GITHUB_TOKEN or QUARTO_WIZARD_TOKEN).

Getting Help

If you encounter issues during installation:

  1. Check the output log: Run Quarto Wizard: Show Quarto Wizard Log Output from the Command Palette.
  2. Verify your internet connection.
  3. See Troubleshooting for common issues and solutions.
Back to top