@lovrabet/rabetbase-cli
v2.3.5
Published
Developer CLI for Lovrabet apps, datasets, pages, SQL, BFF, database connections, skills, and AI agent workflows.
Readme
Rabetbase CLI
Rabetbase CLI is the developer command-line interface for Lovrabet applications. It helps developers, delivery teams, and AI agents create projects, bind workspaces, inspect developer-side app contracts, manage datasets, generate API files, synchronize smart list pages, publish SQL and BFF assets, manage database connections, and prepare agent-ready development workflows from a stable terminal surface.
The CLI is designed for development-time operations. Use it to configure and
publish Lovrabet app assets before they become runtime capabilities. For
runtime business data queries, runtime SQL or BFF execution, and app-specific
business Skills, use the Lovrabet runtime CLI (@lovrabet/lovrabet-cli).
Requirements
- Node.js 20 or later
- A Lovrabet account with access to the target developer app
- Browser login for commands that call the Lovrabet platform
- An existing Lovrabet frontend project, or a new project created by this CLI
Install
npm install -g @lovrabet/rabetbase-cli@latest
rabetbase --version
rabetbase --helpYou can also run a specific version with npm tooling:
npx @lovrabet/rabetbase-cli@latest --helpQuick Start
Authenticate first:
rabetbase auth loginCreate a new Lovrabet frontend project:
rabetbase project create my-app
cd my-appInitialize or update the current workspace app binding:
rabetbase workspace init --appcode <app-code>
rabetbase doctorPull developer-side dataset contracts and generate local API files:
rabetbase api pull --appcode <app-code>Inspect a dataset before changing its structure or generated assets:
rabetbase dataset list --name customer --format pretty
rabetbase dataset detail --code <dataset-code> --format compress
rabetbase dataset operations --code <dataset-code> --format compressUse --format pretty for human-readable output and --format json or
--format compress for scripts and agents.
AI Agent Skill
If your coding environment supports the skills CLI, install the Rabetbase CLI
Built-in Skill so the agent can follow the correct app resolution, dataset
inspection, page, SQL, BFF, and risk-control workflow:
rabetbase cli-skill installEquivalent direct installation:
npx skills add lovrabet/rabetbase -g -yRuntime business Skills are installed with the Lovrabet runtime CLI after selecting the target runtime app:
lovrabet skill installCommon Commands
| Area | Commands |
| --- | --- |
| Authentication | rabetbase auth login, rabetbase auth logout |
| Project and workspace | rabetbase project create, rabetbase project init, rabetbase project upgrade, rabetbase workspace init, rabetbase workspace use |
| App profiles | rabetbase app list, rabetbase app add, rabetbase app remove |
| Dataset contracts | rabetbase dataset list, rabetbase dataset detail, rabetbase dataset operations, rabetbase dataset relations, rabetbase dataset relation-audit |
| Dataset changes | rabetbase dataset generate-start, rabetbase dataset generate-status, rabetbase dataset field-update, rabetbase dataset extend-update, rabetbase dataset business-group-update |
| API generation | rabetbase api list, rabetbase api pull, rabetbase api generate, rabetbase codegen sdk, rabetbase codegen sql |
| Smart list pages | rabetbase page generate-start, rabetbase page generate-status, rabetbase page pull, rabetbase page push, rabetbase page sync, rabetbase page relation-audit |
| SQL and BFF assets | rabetbase sql list, rabetbase sql detail, rabetbase sql create, rabetbase sql push, rabetbase sql validate, rabetbase bff list, rabetbase bff detail, rabetbase bff push |
| Database connections | rabetbase db list, rabetbase db detail, rabetbase db create, rabetbase db test, rabetbase db analyze-start, rabetbase db analyze-status |
| Menu and app config | rabetbase menu list, rabetbase menu sync, rabetbase menu update, rabetbase app-config list, rabetbase app-config get, rabetbase app-config set |
| Diagnostics | rabetbase doctor, rabetbase schema, rabetbase logs show, rabetbase update |
Run command-level help for flags and prerequisites:
rabetbase <service> --help
rabetbase <service> <command> --helpOutput and Automation
Global options are available across commands:
rabetbase dataset list --format json
rabetbase dataset detail --code <dataset-code> --format compress
rabetbase sql push --sqlcode <sql-code> --dry-run
rabetbase bff push --type ENDPOINT --name <function-name> --dry-runImportant options:
--app <name>: select an app profile by name--appcode <code>: override the target app code--env production|daily: choose the target environment--format json|pretty|compress: choose output format--jq <expr>: filter JSON output--dry-run: preview supported write operations--yes: skip confirmation for high-risk writes--non-interactive: force CI-friendly behavior--global: write or read global configuration when the command supports it--project: restrict configuration reads to the current project when supported
Safety Notes
- Inspect developer-side contracts with
dataset detail,dataset operations, or resource-specificdetailcommands before writing changes. - Prefer
--dry-runbefore SQL, BFF, dataset, page, menu, app-config, or database write operations when supported. - Use
--yesonly when the target app, selector, parameters, and impact are already verified. - Project-scoped writes are the default for configuration workflows. Use
--globalonly when you intentionally want to change global CLI state. - Do not commit cookies, access keys, generated credentials, or local user configuration files.
Documentation
- Website: https://www.lovrabet.com
- Developer documentation: https://open.lovrabet.com/
- CLI help:
rabetbase --help
License
Licensed under the terms in LICENSE.
