> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Fintoc CLI

> Install the Fintoc CLI on macOS, Linux, or Windows.

The Fintoc CLI lets you make API requests and listen to webhooks from the command line. You can use the Fintoc CLI to:

* Create, retrieve, update, or delete any of your Fintoc resources in test mode.
* Receive real-time webhooks at `localhost` without a public tunnel and without creating new webhook endpoints.

## Choose an installation method

### npm

The CLI is published to npm and runs on macOS, Linux, and Windows. It requires Node.js >= 22. On Windows, install with npm, since Homebrew is not available. To install with npm run:

```bash theme={null}
npm install -g @fintoc/cli
fintoc --version
```

`npm install -g @fintoc/cli` works in PowerShell and Command Prompt on Windows.

### Homebrew

Homebrew is available on macOS and Linux. To install with Homebrew run:

```bash theme={null}
brew install fintoc-com/tap/fintoc
fintoc --version
```

To update run:

```
brew update && brew upgrade fintoc
```

<br />

## Log in to the CLI

Authenticate the CLI with a Fintoc API key.

```bash theme={null}
fintoc login
```

This opens an interactive flow. If you don't want to use a browser, pass the API key inline with the `--api-key` flag:

```bash theme={null}
fintoc login --api-key sk_test_xxx
```

By default, `fintoc login` authenticates in test mode. Pass `--mode live` to log in to live mode instead.

You can also skip persisting the credential by exporting the `FINTOC_API_KEY` environment variable; the CLI picks it up automatically. See [Fintoc CLI keys](/docs/resources/cli/fintoc-cli-keys-and-permissions) for the full precedence order.

## Verify your setup

`fintoc doctor` verifies your CLI setup. It checks the resolved API key, the Node.js version, the path of the config file, and reachability of api.fintoc.com. Run it to debug authentication or connectivity errors.

```bash theme={null}
fintoc doctor
```