Upgrading from CLI 1.x to 2.0

warning

The original Feishu document has been deleted and can no longer be refreshed from the remote source. This page is temporarily preserved as a historical snapshot. A future decision should be made whether to move it to an archive directory or replace it with a new upgrade document.

Upgrading from CLI 1.x

info

For: Machines that already have Lovrabet CLI 1.x installed, with existing projects using the old CLI. If this is a fresh install, see Quick Start.

2.1 Install the CLI

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

# Verify the installation
rabetbase --version

2.2 Remove the old Lovrabet CLI 1.x

# Uninstall the old version
npm uninstall -g @lovrabet/cli

2.2 Auto-upgrade Existing Projects

info

There are two ways to upgrade an existing project:

Auto-upgrade (recommended)
Manual upgrade (use this if auto-upgrade fails)

Run a single command in each old project directory to complete the migration:

rabetbase project upgrade

This command automatically performs the following 6 migration steps:

Step	Action
1	Rename `.lovrabet.json` to `.rabetbase.json`
2	Delete the `.lovrabet/` directory
3	Delete legacy IDE skill files
4	Clean up MCP configuration (remove old `@lovrabet/dataset-mcp-server` entries)
5	Remove the old skill `lovrabet/lovrabet-skill`
6	Install the new skill `lovrabet/rabetbase`

2.3 Manual Upgrade for Existing Projects

Step 1. Remove the old lovrabet-skill

Rabetbase CLI 2.0 includes all functionality from 1.x, so the old Skill is no longer needed.

# Interactive removal
npx skills remove

# Or remove directly (if it was installed under the lovrabet name)
npx skills remove lovrabet

Step 2. Disable lovrabet-dataset MCP

If the old MCP server is configured locally, it will coexist with the new CLI/Skill system and cause duplicate entries. We recommend disabling it.

Claude Code:

claude mcp remove lovrabet-dataset

Cursor or other IDEs: Open the MCP configuration UI and delete or disable the server entry named lovrabet-dataset.

Config file method: Delete the corresponding configuration block directly:

{
  "mcpServers": {
    "lovrabet-dataset": { ... }  // <- Delete this block
  }
}

Step 3. Install the New Skill

npx skills add lovrabet/rabetbase --global

Note: After a manual migration, confirm that the configuration keys in .rabetbase.json (e.g., appcode) are compatible with the old format.

Checklist (Upgrading from 1.x)

Per machine (do once per machine)

Upgrade CLI: rabetbase update
Remove old Skill: npx skills remove lovrabet
Disable old MCP: claude mcp remove lovrabet-dataset (or remove manually in your IDE)
Install new Skill: npx skills add lovrabet/rabetbase --global
Re-authenticate: rabetbase auth login

Per project (do once per project)

Auto-upgrade: rabetbase project upgrade

Verify

rabetbase doctor
rabetbase --version