kobbe

Kobbe CLI

Inspect analytics, setup health, and site settings from your terminal.

Use the Kobbe CLI when you want quick terminal access to your sites, traffic, setup health, and management commands.

The CLI package is @kobbe/cli. It also includes MCP server mode for AI agents, covered in AI agents.

Install

npm install -g @kobbe/cli

Create an API token in Kobbe → Settings → Account → Agent access. Copy it immediately; Kobbe only shows it once.

Then log in locally:

kobbe login --token kbpat_YOUR_TOKEN

For self-hosted or preview environments, pass a custom app URL:

kobbe login --token kbpat_YOUR_TOKEN --api https://app.kobbe.io

Read analytics

kobbe sites
kobbe overview --site site_123 --range today
kobbe next --site site_123 --range today
kobbe setup-health --site site_123

Use these commands to check what changed, inspect setup health, and find the next page or source worth improving.

Manage sites

Management commands are available when the token has the right scopes:

kobbe create-site --name "Docs site" --domain docs.example.com
kobbe update-site --site site_123 --name "Marketing"
kobbe rotate-token --site site_123

Destructive commands require a typed confirmation:

kobbe delete-site --site site_123 --confirm "DELETE example.com"
kobbe reset-stats --site site_123 --confirm "RESET example.com"

If the confirmation is missing or wrong, Kobbe returns the exact phrase required.