# @wallabyjs/cli

Run [Wallaby](https://wallabyjs.com/) from the command line. The CLI starts Wallaby in standalone mode, so you can use Wallaby UI without an editor extension or plugin.

This package also powers the [Wallaby skill](https://github.com/wallabyjs/skills/blob/main/skills/wallaby-cli/SKILL.md) for coding agents.

The package installs the `wallaby` command.

Use `wallaby --help` to show CLI help, or `wallaby <command> --help` to show command-specific help.

On Windows, use `wallaby-cli` if your shell has trouble running `wallaby`.

## Requirements

- Node.js 22 or later
- A project with a Wallaby configuration, or a framework supported by Wallaby automatic configuration

## Install

Install `@wallabyjs/cli` locally as a project dev dependency or globally.

### Local dev dependency

Choose one:

```sh
npm install --save-dev @wallabyjs/cli
pnpm add --save-dev @wallabyjs/cli
yarn add --dev @wallabyjs/cli
bun add --dev @wallabyjs/cli
```

Run the local CLI with your package manager:

```sh
npx wallaby
pnpm exec wallaby
yarn exec wallaby
bunx wallaby
```

### Global install

Choose one:

```sh
npm install --global @wallabyjs/cli
pnpm add --global @wallabyjs/cli
bun add --global @wallabyjs/cli
```

Then run:

```sh
wallaby
```

## Wallaby skill

Install the skill with either command:

```sh
gh skill install wallabyjs/skills wallaby-cli
npx skills add https://github.com/wallabyjs/skills --skill wallaby-cli
```