@gitbook/cli

Step 1: Install the GitBook CLI

The GitBook Development CLI requires Node v18 or later. It can be installed from NPM using:

npm install @gitbook/cli -g

Step 2: Authenticate with your account

The quickest way to sign in is through your browser:

gitbook login

This opens GitBook in your browser, asks you to authorize the CLI, and stores the resulting token locally. Sessions are refreshed automatically.

Alternatively, authenticate with a personal API token. Create one at app.gitbook.com/account/developer, then run:

gitbook auth --token <token>

Note: Publishing integrations (gitbook integration publish / unpublish) requires a personal API token — the browser (OAuth) session cannot perform those operations. Use gitbook auth for publishing workflows.

To sign out, run gitbook logout.

Step 3: Bootstrap your app

Bootstrap your first app by running:

gitbook integration new