# @faustine-ai/cli

`@faustine-ai/cli` is the npm package of the [Faustine CLI](https://docs.faustine.ai/apps/cli/). It installs one command, `faustine`, which signs in to a gateway, lists its operations and calls them.

| | |
| --- | --- |
| Version | 0.2.2 |
| Command | `faustine` |
| Requires | Node.js 22 or later |
| License | MIT |
| npm | [@faustine-ai/cli](https://www.npmjs.com/package/@faustine-ai/cli) |

## Install

**npm**

```bash
npm install -g @faustine-ai/cli
```

**pnpm**

```bash
pnpm add -g @faustine-ai/cli
```

**yarn**

```bash
yarn global add @faustine-ai/cli
```

**bun**

```bash
bun add -g @faustine-ai/cli
```

To run it once without installing it, use `npx`:

```bash
npx @faustine-ai/cli --help
```

## What changed

| Version | Change |
| --- | --- |
| 0.2.2 | `faustine login` accepts `<domain>/<gateway>` for a gateway on its own domain. |
| 0.2.1 | `faustine call --all` sends a call through every connection of the operation's API. |
| 0.2.0 | The CLI talks to the gateway's REST interface and reads the operations from its OpenAPI document, so it lists every operation whatever the gateway's serving mode. |
| 0.1.0 | First release. |

The package includes a `CHANGELOG.md` with the details.

## Next steps

- [Install the CLI and sign in](https://docs.faustine.ai/apps/cli-install/): sign in to a gateway and list its operations.
- [faustine CLI](https://docs.faustine.ai/reference/faustine-cli/): every command, option, environment variable and exit code.
- [Use the CLI from a coding agent](https://docs.faustine.ai/apps/cli-coding-agents/): run `faustine` from Claude Code or CI.
