> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# CLI Overview

> Build and manage Base44 apps from the command line

The Base44 CLI is a command-line tool for building and managing Base44 apps from your terminal. Create new backend projects, sync data models and code, deploy resources, and run commands against any app on your account, including apps you built in the [Base44 online app editor](https://base44.com/ai-app-builder) and never linked locally.

<Note>
  The CLI and backend service are currently in beta. We're actively improving the platform and documentation based on user feedback. Share your thoughts and feature requests on our [GitHub Discussions page](https://github.com/orgs/base44/discussions).
</Note>

## Installation

```bash theme={null}
npm install -g base44@latest
```

Or run [commands](/developers/references/cli/commands/introduction) directly with npx:

```bash theme={null}
npx base44@latest <command>
```

Requires Node.js 20.19.0 or higher.

## Create projects

Create new Base44 backend projects with the [`create`](/developers/references/cli/commands/create) command. You can choose from available templates to get started quickly.

See our quickstart articles for a detailed walkthrough:

* [Backend-only quickstart](/developers/backend/quickstart/templates/quickstart-backend-only)
* [React quickstart](/developers/backend/quickstart/templates/quickstart-react-template)

## Start from a Base44 app

If you've built an app with the [Base44 app editor](https://base44.com/ai-app-builder), the CLI gives you three ways to work with it.

* **Commands that don't need a local project:** Tail logs, run scripts, manage secrets, and set up connectors for any app you have access to. See [Select a target app](/developers/references/cli/commands/introduction#select-a-target-app).
* **The `sandbox` commands:** Edit the app's code where it already lives, with no local copy. See [Work in the cloud sandbox](#work-in-the-cloud-sandbox).
* **A full local copy:** Develop in your own IDE with the [GitHub integration](/developers/app-code/local-development/github), or take a one-time copy with [`eject`](/developers/references/cli/commands/eject).

## Link existing backend projects

If you have existing Base44 backend project code, such as from an [example app](https://github.com/base44/apps-examples), use the [`link`](/developers/references/cli/commands/link) command to connect it to a Base44 backend. For a step-by-step guide, see [Link an Existing Backend Project](/developers/backend/overview/link-existing-project).

## Manage workspaces

If you belong to multiple workspaces, the CLI can target them directly. Create new apps in a specific workspace with [`create --workspace`](/developers/references/cli/commands/create) or [`link --create --workspace`](/developers/references/cli/commands/link), and move an app between workspaces with [`workspace move`](/developers/references/cli/commands/workspace-move). Use [`workspace list`](/developers/references/cli/commands/workspace-list) and [`workspace get`](/developers/references/cli/commands/workspace-get) to find workspace IDs.

## Manage resources

Define [entity schemas](/developers/backend/resources/entities/overview) as JSON files, write [serverless functions](/developers/backend/resources/backend-functions/overview) in TypeScript, configure [AI agents](/developers/backend/resources/agents/overview), and set up [OAuth connectors](/developers/backend/resources/connectors) for external services. The CLI validates your definitions, reports what changed, and keeps your local and remote resources in sync.

## Inspect workflows

Check the health of your app's [workflows](/Building-your-app/Creating-workflows) from the terminal. List workflows and their run history with [`workflows list`](/developers/references/cli/commands/workflows-list), or look at individual runs across the app, newest first, with [`workflows runs`](/developers/references/cli/commands/workflows-runs).

## Develop locally

Start a local development server with [`dev`](/developers/references/cli/commands/dev) to test your project on your machine without deploying. See the [Local development](/developers/backend/overview/local-dev/local-development-overview) guide for details.

## Work in the cloud sandbox

The `sandbox` commands work the other way around from local development. Instead of running your project on your machine, they connect to the app's [sandbox](/developers/app-code/sandbox/overview), the cloud environment that holds the app's code and runs its development server. There's no checkout and nothing to install, and writing a file is all it takes to save the change.

Explore the app with [`sandbox ls`](/developers/references/cli/commands/sandbox-ls), [`sandbox read`](/developers/references/cli/commands/sandbox-read), and [`sandbox grep`](/developers/references/cli/commands/sandbox-grep). Change it with [`sandbox write`](/developers/references/cli/commands/sandbox-write) and [`sandbox edit`](/developers/references/cli/commands/sandbox-edit), run builds and tests with [`sandbox run`](/developers/references/cli/commands/sandbox-run), and mark a known-good state with [`sandbox checkpoint`](/developers/references/cli/commands/sandbox-checkpoint). This is how you [point your own AI coding agent](/developers/app-code/sandbox/bring-your-own-agent) at a Base44 app. It requires a [Builder plan](/Account-and-billing/Billing-and-plans) or higher.

## Deploy your project

Deploy all your project resources to Base44 with the [`deploy`](/developers/references/cli/commands/deploy) command. This pushes entities, functions, connectors, auth config, and site files in a single operation.

You can also deploy resources individually using [`entities push`](/developers/references/cli/commands/entities-push), [`functions deploy`](/developers/references/cli/commands/functions-deploy), [`actors deploy`](/developers/references/cli/commands/actors-deploy), [`connectors push`](/developers/references/cli/commands/connectors-push), [`auth push`](/developers/references/cli/commands/auth-push), and [`site deploy`](/developers/references/cli/commands/site-deploy).

After deploying, use [`site open`](/developers/references/cli/commands/site-open) to open your live site in the browser. Use [`visibility`](/developers/references/cli/commands/visibility) to control who can access your published app, or set it in `config.jsonc` to apply it on every deploy.

## Configure authentication

Manage your app's login methods from the command line. Pull the current config with [`auth pull`](/developers/references/cli/commands/auth-pull), toggle email/password with [`auth password-login`](/developers/references/cli/commands/auth-password-login), toggle social providers (Google, Microsoft, Facebook, Apple) with [`auth social-login`](/developers/references/cli/commands/auth-social-login), configure an SSO identity provider with [`auth sso`](/developers/references/cli/commands/auth-sso), and push your changes with [`auth push`](/developers/references/cli/commands/auth-push). Auth config is also included when you run [`deploy`](/developers/references/cli/commands/deploy).

## Run scripts

Run standalone TypeScript or JavaScript scripts that interact with your app using [`exec`](/developers/references/cli/commands/exec). A pre-authenticated SDK client is available as a global `base44` variable, so you can access entities, functions, and integrations without any setup code. Pass `--app-id` to target a specific app, or run it inside a linked project to use the project's app. Useful for data migrations, seed scripts, ad-hoc queries, and automation. See the [Standalone scripts](/developers/backend/overview/run-scripts) guide for a full walkthrough.

## See also

* [CLI Command Reference](/developers/references/cli/commands/introduction): All available CLI commands
* [Cloud sandbox](/developers/app-code/sandbox/overview): Work on an app's code in the cloud environment that holds it
* [About the Base44 backend service](/developers/backend/overview/introduction): Learn about Base44 backend features
* [Project Structure](/developers/backend/overview/project-structure): How project files are organized
* [JavaScript SDK](/developers/references/sdk/getting-started/overview): Connect your app to the backend


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.