Set up capture and reviews

Connect your account#

Open Parallax setup and sign in. If your account does not have a GitHub identity, choose Connect GitHub. This attaches GitHub to the same account. If account linking is disabled, contact Conifer support; creating another account is not the repair.

Install the GitHub App and choose the repositories it may review. This selection controls pull-request review access. It does not restrict capture on your computer.

Install on your machine#

Install Node.js 22.13 or newer and Git, then choose your agents and your platform on the setup page. All supported agents are chosen by default. On macOS, Linux, or WSL, keeping every agent selected lets the installer detect which are present. Windows commands explicitly name the selected agents, so the installer may prepare hooks for agents not yet installed. Turn agents off to request a specific selection. Cline capture requires macOS, Linux, or WSL; it is not offered for native Windows. macOS / Linux / WSL gives you a shell command; it also requires curl and tar on PATH. Windows gives you a native PowerShell command; it requires Windows 10 or 11, PowerShell 5.1 or newer, Git for Windows on PATH, and tar.exe (included with Windows). Install on a local drive, not a network share.

Choose Copy install command and run it in that environment. The first click mints a personal capture token; copying again reuses it. Run your coding agent in the same environment as Node.js and the installer. Hooks installed in WSL do not capture an agent running directly in Windows.

Capture on other machines and in the cloud#

Install capture in each environment where your agent runs, including a remote machine or a container you control. Installing on your Mac does not automatically capture hosted Claude or Codex tasks. Those tasks need capture in their execution environment or a supported import integration; the local provider selection does not connect their cloud accounts. The Cloud sessions section of the setup page shows which hosted agents Parallax can capture and how.

Capy uses a separate importer, parallax-capture capy-import, authenticated with a Capy API key in that environment. It is not a provider hook installed by this command. Importing a transcript also does not establish that an agent is currently running or waiting for you.

Choose repositories to capture#

Each machine has its own capture allowlist. Set it to existing absolute repository paths; paths include their descendants and are not globs. On macOS, Linux or WSL:

node "$HOME/.parallax-client/app/capture/bin/parallax-capture.mjs" setup --repos /absolute/path/to/repository

In Windows PowerShell:

node "$HOME/.parallax-client/app/capture/bin/parallax-capture.mjs" setup --repos "C:\path\to\repository"

A comma-separated list replaces the current selection. An empty list returns to capturing every repository; it does not disable capture. Removing parallax.yml or uninstalling the GitHub App does not stop local capture. The optional parallax.yml file supplies repository commands used by reviews:

test: npm test

Enable session reviews#

The capture token connects this machine to your account. Reviews run in the cloud. A new account gets 5 free episodes; after that, each new episode uses one Parallax credit. Retrying the same episode uses no extra credit. Episode creditsshows the current price, free episodes remaining, and available credit packs.

Keep the capture token private. Give other developers the setup page so they mint their own capture tokens. Existing capture tokens remain valid until revoked in setup.

Confirm the installation#

Restart your selected agents and accept any new hook trust prompt. Run the installed doctor to check hook wiring and a synthetic local session, then check captured sessions and review delivery:

node "$HOME/.parallax-client/app/capture/bin/parallax-capture.mjs" doctor
node "$HOME/.parallax-client/app/capture/bin/parallax-capture.mjs" status
node "$HOME/.parallax-client/app/session-review/bin/session-review.mjs" status

Open Sessions to confirm a real session reached your account. Eligible episodes produce reviews on the Sessions page. A copied command alone does not prove installation or delivery succeeded.

Stop uploads or remove capture#

To stop automatic capture uploads, set PARALLAX_STORE_UPLOAD=off in the environment before starting your coding agent. In PowerShell use $env:PARALLAX_STORE_UPLOAD = 'off'; in a POSIX shell use export PARALLAX_STORE_UPLOAD=off. This does not stop local capture; an explicit upload command can still send a session. Separately enabled session reviews still send review requests and reports. Remove the review hooks below to stop automatic reviews.

To remove review and capture hooks on this machine, close your coding agents and run:

node "$HOME/.parallax-client/app/session-review/bin/session-review.mjs" uninstall
node "$HOME/.parallax-client/app/capture/bin/parallax-capture.mjs" uninstall

Restart the agents afterwards. These commands preserve local history by default and do not erase sessions already uploaded. Do not delete the configuration file as an opt-out: a missing allowlist means all repositories. To prevent further use of an upload credential, revoke its capture token in setup.