---
title: Install the command-line tool
description: Install the Rinhelp CLI on macOS or Linux.
sidebar:
  order: 1
---

Install `rinhelp` to use your workspace from a terminal. You need a Rinhelp account to sign in.

## Requirements

- macOS or Linux.
- Node.js 22 or later.
- `curl`, `mktemp`, and `awk`.
- `sha256sum` or `shasum` for the download check.
- A writable directory on your `PATH`.

The installer supports x86_64, amd64, arm64, and aarch64 CPUs.

## Install

Run:

```sh
curl -fsSL https://rinhelp.com/install-cli | bash
```

The installer verifies the download and installs `rinhelp` in the first writable directory on your `PATH`. It does not use `sudo` or edit shell profiles.

If no directory on your `PATH` is writable, set `RINHELP_INSTALL_DIR` to an existing writable directory that is already on `PATH`:

```sh
export RINHELP_INSTALL_DIR="$HOME/.local/bin"
curl -fsSL https://rinhelp.com/install-cli | bash
```

Open a new shell if your own shell setup needs it, then check the command:

```sh
rinhelp --help
```

## Sign in

Run:

```sh
rinhelp login
```

The CLI opens a browser sign-in. Approve access for Rinhelp, then return to the terminal. The CLI saves your sign-in on this computer. If it asks you to sign in again, run `rinhelp login`.

Run `rinhelp logout` to remove the saved credential. For a script or CI job, `RINHELP_ACCESS_TOKEN` can provide an access token without browser login. You must replace an environment token when it expires.

If the installer returns `CLI installer is unavailable`, the download is not available. Try again later.