base44

Base44 CLI

Command-line interface for building applications with Base44's backend service.

Base44's backend service provides a managed backend for your applications, including data storage with entities, serverless functions, authentication, and hosting. The CLI lets you:

• Create projects from templates.
• Sync resources defined in local code with your Base44 backend.
• Deploy sites to Base44's hosting platform.

To get started, see the full list of commands below or check out the documentation.

Installation

npm install -g base44

Or run commands directly with npx:

npx base44 <command>

Requires Node.js 20.19.0 or higher.

Quick start

# Authenticate
base44 login

# Create a project
base44 create

The CLI will guide you through project setup. For step-by-step tutorials, see the quickstart guides:

• Backend only — for headless apps or custom frontends
• React — full-stack with Vite + React

Commands

Command	Description
create	Create a new Base44 project from a template
deploy	Deploy all project resources and site to Base44
eject	Download the code for an existing Base44 project
link	Link a local project to a Base44 project
dashboard open	Open the app dashboard in your browser
login	Authenticate with Base44
logout	Sign out and clear stored credentials
whoami	Display the current authenticated user
agents pull	Pull agents from Base44 to local files
agents push	Push local agents to Base44
connectors initiate	Initialize a connector on an app and start its OAuth flow
connectors pull	Pull connectors from Base44 to local files
connectors push	Push local connectors to Base44
entities push	Push local entities to Base44
functions deploy	Deploy local functions to Base44
secrets list	List project secret names
secrets set	Set one or more project secrets
secrets delete	Delete a project secret
sandbox ls	List directory entries in an app's remote sandbox
sandbox read	Read file contents from an app's remote sandbox
sandbox write	Create or overwrite a file in an app's remote sandbox
sandbox edit	Apply exact old→new string edits to a file in the sandbox
sandbox grep	Search files for a pattern in an app's remote sandbox
sandbox run	Run a shell command in an app's remote sandbox
sandbox checkpoint	Create a restore-point checkpoint of an app's remote sandbox
site deploy	Deploy built site files to Base44 hosting
site open	Open the published site in your browser
types generate	Generate TypeScript types from project resources

Global flags

These work with any command:

Flag	Description
--app-id <id>	Target a Base44 app explicitly (overrides the linked project and BASE44_APP_ID)
--json	Emit machine-readable JSON to stdout and run in silent mode

--json

Use --json for scripting and agent automation:

• stdout is a single JSON document — pipe it straight into jq.
• Silent mode — interactive prompts, the spinner, and human status lines are suppressed; all status and diagnostics go to stderr, so stdout stays pure JSON.
• Errors are JSON too — a failure prints { "error": "...", "code": "...", "hints": [...] } to stdout and exits non-zero, so you can parse success and failure from the same stream.
• Every command accepts it. Commands with structured output (e.g. sandbox, connectors) return rich JSON; others fall back to { "output": "<status>" }.

# Pure JSON on stdout, ready for jq
base44 sandbox ls src --app-id app_123 --json | jq '.entries'
base44 sandbox run "npm test" --app-id app_123 --json | jq '.exitCode'

AI agent skills

When creating a project, base44/skills are automatically installed. These help AI agents understand how to work with Base44 projects.

If you need to install skills manually, use the following command:

npx skills add base44/skills

Help

base44 --help
base44 <command> --help

Version

base44 --version

Beta

The CLI and Base44 backend service are currently in beta. We're actively improving them based on user feedback. Share your thoughts and feature requests on our GitHub Discussions.

Found a bug? Open an issue.

License

MIT