# @rebasepro/cli

Developer CLI for scaffolding, running, and managing Rebase projects.

## Installation

```bash
pnpm add -g @rebasepro/cli
```

The CLI is also bundled with every Rebase project as a local dependency.

## Commands

| Command | Description |
|---------|-------------|
| `rebase init` | Scaffold a new Rebase project |
| `rebase dev` | Start the development server (backend + frontend) |
| `rebase build` | Build all workspace packages |
| `rebase start` | Start the backend server (production) |
| `rebase schema generate` | Generate Drizzle schema from collection definitions |
| `rebase schema introspect` | Introspect an existing database → Rebase collections |
| `rebase db push` | Apply schema directly to database (dev). Previews the plan and refuses destructive changes (e.g. dropped columns) unless confirmed interactively or run with `--allow-destructive`. |
| `rebase db generate` | Generate SQL migration files |
| `rebase db migrate` | Run pending migrations |
| `rebase generate-sdk` | Generate a typed TypeScript SDK from collections |
| `rebase auth reset-password` | Reset a user's password |
| `rebase doctor` | Detect schema drift between collections, Drizzle schema, and database |
| `rebase cloud <command>` | Manage your apps on Rebase Cloud (auth, deploy, databases, …) |

Run `rebase --help` or `rebase <command> --help` for detailed usage.

## Rebase Cloud

`rebase cloud` talks to the hosted control plane (default `https://app.rebase.pro`,
override with `--url` or `REBASE_CLOUD_URL`). Sign in once — credentials are stored
in `~/.rebase/credentials.json`, keyed per host — then link a directory to a project
so deploy/logs/status need no flags.

```bash
rebase cloud login                 # sign in (stores a session)
rebase cloud link                  # pick a project → writes .rebase/cloud.json
rebase cloud deploy                # deploy the linked project + stream build logs
rebase cloud logs --runtime        # tail runtime logs
rebase cloud status                # project status at a glance
```

| Group | Commands |
|-------|----------|
| Auth | `login`, `logout`, `whoami` |
| Link/context | `link`, `unlink`, `use [org]`, `open` |
| Projects | `projects list \| create \| info \| delete` |
| Deploy/observe | `deploy`, `logs [--runtime] [-f]`, `status`, `metrics` |
| Organizations | `orgs list \| create \| members` |
| Databases | `db list \| create \| test`, `db backup list \| create \| restore` |
| Resources | `webhooks list \| create \| delete`, `storage`, `clusters`, `billing [checkout]` |

Most commands act on the linked project unless you pass `--project <id>`.
Run `rebase cloud --help` for the full list.

## Quick Start

```bash
rebase init my-app
cd my-app
docker compose up -d db
pnpm run db:push
pnpm run dev
```

## Related Packages

| Package | Role |
|---------|------|
| `@rebasepro/server` | Backend framework used by `dev` and `start` |
| `@rebasepro/server-postgres` | PostgreSQL driver used by schema/db commands |
| `@rebasepro/codegen` | Powers `generate-sdk` |
| `@rebasepro/types` | Shared type definitions |