Install on macOS

Option A — install script (recommended)

1. 1

   Run the install script

   Open Terminal and run the one-line installer. It downloads the latest signed binary, places it in /usr/local/bin/qoc, and verifies the checksum automatically.

2. 2

   Confirm the binary is on your PATH

   Run which qoc. You should see /usr/local/bin/qoc. If the shell cannot find it, add /usr/local/bin to your PATH in ~/.zshrc and reload with source ~/.zshrc.

3. 3

   Start the desk service

   Run qoc up to start the local service. It binds to localhost:7070 and writes a PID file to ~/.qoc/service.pid. Leave this terminal session open or run it in the background with qoc up --daemon.

4. 4

   Verify the installation

   Open a new terminal tab and run qoc status. You should see the version number and service running in the output.

Install script command

curl -fsSL https://qoc.app/install.sh | bash

Option B — Homebrew-style tap

1. 1

   Add the Qoc tap

   Run brew tap qoc-app/qoc to register the tap. This only needs to be done once per machine.

2. 2

   Install the formula

   Run brew install qoc. Homebrew resolves the Node dependency automatically if it is not already present.

3. 3

   Start and verify

   Run qoc up and then qoc status in a new terminal to confirm the service is running.

Homebrew tap commands

brew tap qoc-app/qoc
brew install qoc
qoc up
qoc status

First-run checks

On first launch, macOS Gatekeeper may prompt you to confirm the binary is safe to run. Open System Settings → Privacy & Security and click Allow Anyway next to the qoc entry, or run xattr -d com.apple.quarantine /usr/local/bin/qoc to clear the quarantine flag from the command line.

The service writes logs to ~/.qoc/logs/service.log. If qoc up exits immediately, check that file for a port conflict — you can change the default port in desk.toml under the [workspace] section.

What to do next