gem-hunter
Language: TypeScript
Command-line interface for building applications with Base44's backend service.
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:
To get started, see the full list of commands below or check out the documentation.
npm install -g base44
Or run commands directly with npx:
npx base44 <command>
Requires Node.js 20.19.0 or higher.
# 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:
| Command | Description |
|---|---|
api catalog [area] |
List the API's areas, or every operation in one area |
api search <text> |
Search every public Base44 API operation by what it does |
api grep <pattern> |
Search the API spec with a regular expression, for when search misses |
api fetch <METHOD> <path> |
Call any public Base44 API operation; --help after a path prints its contract |
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 |
Save a restore point in the builder's version history; run it after each unit of work, since sandbox writes are committed but not checkpointed and a Restore or Revert in the builder discards everything after the last checkpoint |
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 |
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 |
Use --json for scripting and agent automation:
jq.{ "error": "...", "code": "...", "hints": [...] } to stdout and exits non-zero, so you can parse success and failure from the same stream.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'
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
base44 --help base44 <command> --help
base44 --version
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.
MIT