Install

Install the App on a computer with a screen. On WSL2, a dev container or a server, install the command line and open the App in your browser.

Open full size ↗ Open full size ↗

What you need

A computermacOS, Windows or Linux, with Git.

A repositoryAny Git repository you work in.

A coding agentA supported or other agent, signed in and started once.

On your computer

1. Download the App

   macOS and Linux

   Download the App and open it.

   Windows

   Download the App, or install the App and the command line from PowerShell:

   irm https://qualitylayer.dev/install.ps1 | iex

2. Run Setup

   Setup activates your licence or 7-day trial, installs the qualitylayer command and connects your agents and recent repositories.

Agent setup

Setup adds missing Claude Code, Codex and Grok settings, such as native task tools, commits without attribution and questions that wait for you (full list). Settings you chose stay.

Warning

If you have not chosen native permissions, Claude Code starts in Bypass and Codex in Full access, also outside QualityLayer. Choose another mode in Settings › Agents › Edit launch… or in the agent itself.

Without the desktop App

qualitylayer app opens the same workspace in your browser. Agents run where QualityLayer is installed.

WSL2, dev containers and servers

Open full size ↗ Open full size ↗

Install QualityLayer where your agent runs. No App is needed there, and you can work only in your agent.

curl -fsSL https://qualitylayer.dev/install.sh | bash

WSL2

The pages open in your Windows browser.

Dev container

The pages open in your browser; VS Code forwards the port. In the App, add the container as a machine.

To keep QualityLayer and your agent's sign-in when the container is rebuilt, keep them in volumes:

.devcontainer/devcontainer.json

"mounts": [
  "source=qualitylayer-${devcontainerId},target=/home/vscode/.qualitylayer,type=volume",
  "source=claude-${devcontainerId},target=/home/vscode/.claude,type=volume"
],
"postCreateCommand": "sudo chown vscode ~/.qualitylayer ~/.claude && curl -fsSL https://claude.ai/install.sh | bash && curl -fsSL https://qualitylayer.dev/install.sh | bash"

Server over ssh

In the App, add it as a machine, which also installs QualityLayer there. In a browser, VS Code Remote-SSH forwards the port for you; with plain ssh, forward the port that qualitylayer app pair prints.

A port for each machine

Machines added in Settings › Machines need no port of yours. In a browser, the server listens on port 41888 (41910 on WSL2), or the next free one. Two remote machines cannot both forward to 41888 on your laptop, so give each its own:

qualitylayer settings set cockpit.port 41901   # on the server
qualitylayer app restart
ssh -N -L 41901:127.0.0.1:41901 first-server   # on your laptop

Then open http://127.0.0.1:41901. QUALITYLAYER_PORT=41901 qualitylayer app restart tries a port once without saving it (Server settings).

Updates

In the App, choose Restart and update from Update ready or the bar above the page. Without the App, run qualitylayer update; if a 12.x install finds no update, run the installation command again. Choose Stable or Beta in Settings › About.

Remove it

macOS and Linux

qualitylayer uninstall undoes what the installer changed; your plans stay. Add --purge to remove QualityLayer's settings, licence and tasks too.

Windows

This works even when the App or command line is blocked or gone. Your plans, logins, licence and tasks stay; add -Purge to remove QualityLayer's settings, licence and tasks too.

& ([scriptblock]::Create((irm https://qualitylayer.dev/install.ps1))) -Uninstall

Note

To move your licence, run qualitylayer licence activate <key> on the other computer. A key works on 5 computers (Licence).

Windows with Intune or Defender Exploit Guard

If Defender Exploit Guard blocks Setup or removes installed files, check your managed-device policy with IT.

Fix	How
Exclusion (IT)	Exclude %LOCALAPPDATA%\QualityLayer and %USERPROFILE%\.qualitylayer\bin (Intune: Attack Surface Reduction Only Exclusions)
File indicator (IT)	Allow the setup file by its SHA-256 from SHA256SUMS on the release page
WSL (no IT)	Install in WSL2

Then run qualitylayer doctor and open the App once. If code health setup fails because antivirus holds its tools, see Setup under antivirus.