Base44 CLI

概览

GitHubGitHub

Base44 CLI 是一个基于 TypeScript 编写的命令行工具，用于配合 Base44 托管后端服务进行应用开发。Base44 后端提供实体数据存储、Serverless 函数、身份认证和站点托管等能力，CLI 则负责在本地开发环境与云端之间建立工作流。 ## 核心用途 - **项目创建**：通过模板初始化新的 Base44 项目，支持纯后端（headless）或 Vite + React 全栈模式。 - **资源同步**：将本地代码中定义的 entities、functions、agents、connectors 等资源推送到 Base44 后端，或将云端配置拉取到本地。 - **站点部署**：将构建好的前端文件部署到 Base44 的托管平台。 ## 主要能力 CLI 提供了覆盖完整开发周期的命令集： - **项目管理**：`create`、`link`、`eject`、`deploy` 用于创建、关联、导出和整体部署项目。 - **身份认证**：`login`、`logout`、`whoami` 管理登录状态。 - **资源操作**：针对 agents、connectors、entities、functions 分别提供 push/pull/deploy 命令。 - **密钥管理**：`secrets list`、`secrets set`、`secrets delete` 管理项目环境变量。 - **远程沙箱**：`sandbox` 子命令支持在远程环境中列出目录、读写文件、执行 shell 命令、搜索内容以及创建版本检查点（checkpoint）。 - **类型生成**：`types generate` 根据项目资源自动生成 TypeScript 类型定义。 ## JSON 输出与自动化 所有命令均支持 `--json` 全局标志。启用后，stdout 仅输出单个 JSON 文档，交互式提示和状态信息会被抑制并输出到 stderr，错误也会以结构化 JSON 形式返回。这使得 CLI 可以直接与 `jq` 等工具配合，适用于脚本编写和 AI agent 自动化场景。 ## AI Agent 支持 创建项目时会自动安装 base44/skills，帮助 AI agent 理解如何操作 Base44 项目。也可通过 `npx skills add base44/skills` 手动安装。 该工具要求 Node.js 20.19.0 或更高版本，目前处于 beta 阶段，采用 MIT 协议开源。

Q&A

安装 Base44 CLI 需要什么环境？由 AI 生成

需要 Node.js 20.19.0 或更高版本。可通过 npm install -g base44 全局安装，或使用 npx base44 <command> 直接运行。

如何让 CLI 输出适合程序解析的格式？由 AI 生成

在任何命令后添加 --json 标志。此时 stdout 会输出单个 JSON 文档，交互提示和状态信息转到 stderr，错误也以 JSON 格式返回，可直接用 jq 处理。

sandbox checkpoint 命令的作用是什么？由 AI 生成

在 builder 的版本历史中保存一个恢复点。因为 sandbox 的写入操作会被提交但不会自动创建检查点，如果在 builder 中执行 Restore 或 Revert，最后一次检查点之后的所有更改都会被丢弃。

Base44 CLI 目前处于什么阶段？由 AI 生成

CLI 和 Base44 后端服务目前均处于 beta 阶段。

如何为 AI agent 安装 Base44 skills？由 AI 生成

创建项目时会自动安装。如需手动安装，可运行 npx skills add base44/skills。