Skip to main content

Quick Start

This guide shows how to get started with Rabetbase CLI 2.0 in both new and existing projects.

The current content has been verified against rabetbase-cli v2.2.2 and @lovrabet/cli-framework v1.0.3. Recent versions bundle a jq binary directly in the CLI; write commands keep their preview and confirmation flow, which works well for Agent-driven development.

If you are already using AI coding tools such as Claude Code, Codex, Cursor, Trae, or Windsurf, you can simply copy the prompt below into your AI assistant. It will install the CLI, install the Skill, and handle authentication — you only need to help with browser authorization or project confirmation when prompted.

Prompt (copy and paste into your AI assistant):

Please install Rabetbase CLI: https://www.lovrabet.com/agent-install-guides/rabetbase-cli.md

The most common point where Agent-based setup pauses is browser authorization: when the Agent prints an actual Login URL, open it, complete authorization in the browser, then return and say "authorization completed."

If the Agent asks whether to initialize a project, confirm only when the current directory is the real target project. Installing the CLI alone does not require rabetbase project init.

Supported AI Agent tools: Claude Code, Codex, Cursor, Trae, Windsurf, GitHub Copilot, OpenCode, Hermes Agent, OpenClaw

💡 If you prefer to control each step yourself, or do not use an AI Agent tool, continue with the manual installation below.

Manual Install​

For: First-time Rabetbase CLI users on a machine that has never installed any previous version.

>> Click here for the installation video walkthrough

1.1 Install the CLI​

Package: @lovrabet/rabetbase-cli

# Global install (recommended)
npm install -g @lovrabet/rabetbase-cli@latest

# Verify the installation
rabetbase --version

Latest version: npm version

1.2 Install the Rabetbase Skill​

The recommended way is to use the built-in CLI entry:

rabetbase skill install

If you prefer the raw skills command, you can still run:

npx skills add lovrabet/rabetbase -g -y

A global install is recommended so AI assistants can use rabetbase from any project directory.

1.3 Authentication​

rabetbase auth login

A browser window will open for OAuth login. The CLI saves the session automatically, and one login works across projects.

1.4 Initialize a Project​

Initialize an existing project directory:

cd your-project/
rabetbase project init

Create a brand-new project from scratch:

rabetbase project create

1.5 Quick Verification​

rabetbase doctor
rabetbase schema --format compress
rabetbase app list --format compress

If you want to verify that --jq is already available, run:

rabetbase schema --format compress --jq '.data.cli.version'

2. Most Important Changes in the Current Version​

  • --jq is now more reliable: The latest build bundles jq as a sidecar, so installation no longer depends on node-jq downloading binaries from GitHub.
  • Dataset lists are more complete by default: rabetbase dataset list returns DO V2 datasets, including both DB_TABLE and METADATA. Use --source DB_TABLE for database-backed datasets, or --source METADATA for metadata datasets.
  • Writes are safer by default: rabetbase page generate-start now returns a dry-run preview by default, and a real generation job requires --apply; project-scope writes also avoid leaking global app config into project files.
  • Dataset write commands must target explicitly: dataset rename, field-update, extend-update, and delete require --code, --id, or --dbid, and should be previewed with --dry-run first.
  • Menu resource updates are more conservative: rabetbase menu update preserves existing page extend config while updating CDN resource URLs, reducing the risk of overwriting protected settings.
  • You can inspect real data directly from the dev CLI: rabetbase data filter and rabetbase data getOne are now part of the official command surface.
  • Skill installation is more consistent: You can now simply run rabetbase skill install without remembering the lower-level npx skills add ... form.

3. Checklist​

Install and Verify​

  • Install CLI: npm install -g @lovrabet/rabetbase-cli@latest
  • Install Skill: rabetbase skill install
  • Authenticate: rabetbase auth login
  • Initialize the project: rabetbase project init or rabetbase project create
  • Verify: rabetbase doctor

4. Next Steps​