Installation

rq is a domain-specific language designed for managing and executing HTTP requests.

This document describes how to install the rq VS Code extension.

VS Code extension

The rq VS Code extension is distributed through the VS Code Marketplace

VS Code Extension (Manual Install from VSIX)

Each release publishes a .vsix file as a release asset on GitHub. You can download and install it manually if you prefer not to use the Marketplace.

1. Go to the Releases page and open the release you want.
2. Under Assets, download the .vsix file (e.g. rq-language-extension-0.2.0.vsix).
3. Open VS Code and go to the Extensions view (Ctrl+Shift+X / Cmd+Shift+X).
4. Click the ... icon (top-right of the Extensions panel, next to the refresh button).
5. Select Install from VSIX… and choose the downloaded file.

CLI (Manual Download)

If you want to use the rq CLI independently, you can download the prebuilt portable binary directly from the GitHub Releases page. The binaries are self-contained and do not require any additional runtime or installation steps.

1. Open the Releases page in your browser:
   • https://github.com/rqlang/rq/releases
2. In the Assets section of the release, download the file that matches your platform:
   • Windows: rq-windows-x86_64.exe
   • Linux (Ubuntu 22.04 x86_64): rq-linux-ubuntu-22.04-x86_64
   • Linux (other x86_64): rq-linux-x86_64
   • macOS Intel (x86_64): rq-macos-x86_64
   • macOS Apple Silicon (M1/M2): rq-macos-aarch64
3. Optionally rename the downloaded file to a shorter name (for example rq).
4. Make the file executable (Linux / macOS):

  chmod +x ./rq-linux-x86_64

1. Either run it directly from the download location:

  ./rq-linux-x86_64 --version

Or move it to a directory on your `PATH` (for example `/usr/local/bin` or `~/.local/bin`) and run it from anywhere:

  mv ./rq-linux-x86_64 /usr/local/bin/rq
  rq --version

On Windows, you can run the portable executable directly after downloading (for example from your Downloads folder):

cd $env:USERPROFILE\Downloads
./rq-windows-x86_64.exe --version

For convenience, you can also move rq-windows-x86_64.exe to a folder that is already on your PATH (or update the PATH environment variable) so that you can run rq from any directory.