base44 0.0.16 → 0.0.18

package/README.md

@@ -1,193 +1,109 @@
 # Base44 CLI
 
-A unified command-line interface for managing Base44 applications, entities, functions, deployments, and related services.
+Command-line interface for building applications with [Base44's backend service](https://docs.base44.com/developers/backend/overview/introduction).
 
-**Zero dependencies** - installs in seconds with no dependency resolution.
+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](https://docs.base44.com/developers/references/cli/get-started/overview).
 
 ## Installation
 
 ```bash
-# Using npm (globally)
 npm install -g base44
-
-# Or run directly with npx
-npx base44 <command>
 ```
 
-## Quick Start
+Or run commands directly with npx:
 
 ```bash
-# 1. Login to Base44
-base44 login
-
-# 2. Create a new project
-base44 create
-
-# 3. Deploy everything (entities, functions, and site)
-npm run build
-base44 deploy
+npx base44 <command>
 ```
 
-## Commands
-
-### Authentication
+Requires Node.js 20.19.0 or higher.
 
-| Command | Description |
-|---------|-------------|
-| `base44 login` | Authenticate with Base44 using device code flow |
-| `base44 whoami` | Display current authenticated user |
-| `base44 logout` | Logout from current device |
-
-### Project Management
-
-| Command | Description |
-|---------|-------------|
-| `base44 create` | Create a new Base44 project from a template |
-| `base44 link` | Link a local project to Base44 (create new or link existing) |
-| `base44 dashboard` | Open the app dashboard in your browser |
-
-#### Link Command Options
-
-The `link` command supports both creating new projects and linking to existing ones:
+## Quick start
 
 ```bash
-# Interactive mode - choose to create new or link existing
-base44 link
-
-# Create a new project (non-interactive)
-base44 link --create --name "my-app" --description "My app description"
+# Authenticate
+base44 login
 
-# Link to an existing project by ID (non-interactive)
-base44 link --existing <app-id>
+# Create a project
+base44 create
 ```
 
-| Option | Description |
-|--------|-------------|
-| `-c, --create` | Create a new project (skip selection prompt) |
-| `-e, --existing <id>` | Link to an existing project by ID |
-| `-n, --name <name>` | Project name (required with --create) |
-| `-d, --description <desc>` | Project description (optional) |
+The CLI will guide you through project setup. For step-by-step tutorials, see the quickstart guides:
 
-### Deployment
-
-| Command | Description |
-|---------|-------------|
-| `base44 deploy` | Deploy all resources (entities, functions, and site) |
+- [Backend only](https://docs.base44.com/developers/backend/quickstart/quickstart-backend-only) — for headless apps or custom frontends
+- [React](https://docs.base44.com/developers/backend/quickstart/quickstart-with-react) — full-stack with Vite + React
 
-### Entities
-
-| Command | Description |
-|---------|-------------|
-| `base44 entities push` | Push local entity schemas to Base44 |
-
-### Functions
+## Commands
 
 | Command | Description |
-|---------|-------------|
-| `base44 functions deploy` | Deploy local functions to Base44 |
-
-### Site
+| ------- | ----------- |
+| [`create`](https://docs.base44.com/developers/references/cli/commands/create) | Create a new Base44 project from a template |
+| [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) | Deploy resources and site to Base44 |
+| [`link`](https://docs.base44.com/developers/references/cli/commands/link) | Link a local project to a project on Base44 |
+| [`dashboard`](https://docs.base44.com/developers/references/cli/commands/dashboard) | Open the app dashboard in your browser |
+| [`login`](https://docs.base44.com/developers/references/cli/commands/login) | Authenticate with Base44 |
+| [`logout`](https://docs.base44.com/developers/references/cli/commands/logout) | Sign out and clear stored credentials |
+| [`whoami`](https://docs.base44.com/developers/references/cli/commands/whoami) | Display the current authenticated user |
+| [`entities push`](https://docs.base44.com/developers/references/cli/commands/entities-push) | Push local entity schemas to Base44 |
+| [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy) | Deploy local functions to Base44 |
+| [`site deploy`](https://docs.base44.com/developers/references/cli/commands/site-deploy) | Deploy built site files to Base44 hosting |
 
-| Command | Description |
-|---------|-------------|
-| `base44 site deploy` | Deploy built site files to Base44 hosting |
 
-## Configuration
+<!--| [`eject`](https://docs.base44.com/developers/references/cli/commands/eject) | Create a Base44 backend project from an existing Base44 app | -->
 
-### Project Configuration
+## AI Agent Skills
 
-Base44 projects are configured via a `config.jsonc` (or `config.json`) file in the `base44/` subdirectory:
+When creating a project, you'll be prompted to install AI agent skills for your preferred coding assistants:
 
-```jsonc
-// base44/config.jsonc
-{
-  "name": "My Project",
-  "entitiesDir": "./entities",   // Default: ./entities
-  "functionsDir": "./functions", // Default: ./functions
-  "site": {
-    "outputDirectory": "../dist" // Path to built site files
-  }
-}
 ```
-
-### App Configuration
-
-Your app ID is stored in a `.app.jsonc` file in the `base44/` directory. This file is created automatically when you run `base44 create` or `base44 link`:
-
-```jsonc
-// base44/.app.jsonc
-{
-  "id": "your-app-id"
-}
+◆  Add AI agent skills? (Select agents to configure)
+│  ◼ Cursor
+│  ◼ Claude Code
+└
 ```
 
-## Project Structure
+This installs [base44/skills](https://github.com/base44/skills) which helps AI agents understand how to work with Base44 projects.
 
-A typical Base44 project has this structure:
-
-```
-my-project/
-├── base44/
-│   ├── config.jsonc           # Project configuration
-│   ├── .app.jsonc             # App ID (git-ignored)
-│   ├── entities/              # Entity schema files
-│   │   ├── user.jsonc
-│   │   └── product.jsonc
-│   └── functions/             # Backend functions
-│       └── my-function/
-│           ├── config.jsonc
-│           └── index.js
-├── src/                       # Your frontend code
-├── dist/                      # Built site files (for deployment)
-└── package.json
-```
-
-## Development
-
-### Prerequisites
-
-- Node.js >= 20.19.0
-- npm
-
-### Setup
+**Non-interactive mode:**
 
 ```bash
-# Clone the repository
-git clone https://github.com/base44/cli.git
-cd cli
+# Install skills for all supported agents
+base44 create --name my-app --path ./my-app --skills
 
-# Install dependencies
-npm install
+# Skip skills installation
+base44 create --name my-app --path ./my-app
+```
 
-# Build
-npm run build
+**Manual installation:**
 
-# Run in development mode
-npm run dev -- <command>
+```bash
+npx add-skill base44/skills
 ```
 
-### Available Scripts
+## Help
 
 ```bash
-npm run build      # Build with tsdown
-npm run typecheck  # Type check with tsc
-npm run dev        # Run in development mode with tsx
-npm run lint       # Lint with ESLint
-npm test           # Run tests with Vitest
+base44 --help
+base44 <command> --help
 ```
 
-### Running the Built CLI
+## Version
 
 ```bash
-# After building
-npm start -- <command>
-
-# Or directly
-./dist/cli/index.js <command>
+base44 --version
 ```
-## Contributing
 
-See [AGENTS.md](./AGENTS.md) for development guidelines and architecture documentation.
+## Alpha
+
+The CLI and Base44 backend service are currently in alpha. We're actively improving them based on user feedback. Share your thoughts and feature requests on our [GitHub Discussions](https://github.com/orgs/base44/discussions).
+
+Found a bug? [Open an issue](https://github.com/base44/cli/issues).
 
 ## License
 

package/bin/dev.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env tsx
+import { program, CLIExitError } from "../src/cli/index.ts";
+
+try {
+  await program.parseAsync();
+} catch (error) {
+  if (error instanceof CLIExitError) {
+    process.exit(error.code);
+  }
+  console.error(error);
+  process.exit(1);
+}

package/bin/run.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { program, CLIExitError } from "../dist/index.js";
+
+try {
+  await program.parseAsync();
+} catch (error) {
+  if (error instanceof CLIExitError) {
+    process.exit(error.code);
+  }
+  console.error(error);
+  process.exit(1);
+}

package/dist/{cli/index.js → index.js}

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { createRequire } from "node:module";
 import { EventEmitter, addAbortListener, on, once, setMaxListeners } from "node:events";
 import childProcess, { ChildProcess, execFile, spawn, spawnSync } from "node:child_process";
@@ -16798,7 +16797,10 @@ async function createProject(projectName, description) {
 	return { projectId: CreateProjectResponseSchema.parse(await response.json()).id };
 }
 async function listProjects() {
-	const response = await base44Client.get(`api/apps?sort=-updated_date&fields=id,name,user_description,is_managed_source_code`);
+	const response = await base44Client.get(`api/apps`, { searchParams: {
+		"sort": "-updated_date",
+		"fields": "id,name,user_description,is_managed_source_code"
+	} });
 	return ProjectsResponseSchema.parse(await response.json());
 }
 
@@ -30583,6 +30585,21 @@ async function getUserInfo(accessToken) {
 	return result.data;
 }
 
+//#endregion
+//#region src/cli/errors.ts
+/**
+* Error thrown to signal a controlled CLI exit with a specific exit code.
+* This allows proper error propagation without calling process.exit() directly,
+* making the code more testable and maintaining a single exit point.
+*/
+var CLIExitError = class extends Error {
+	constructor(code$1) {
+		super(`CLI exited with code ${code$1}`);
+		this.code = code$1;
+		this.name = "CLIExitError";
+	}
+};
+
 //#endregion
 //#region node_modules/chalk/source/vendor/ansi-styles/index.js
 const ANSI_BACKGROUND_OFFSET = 10;
@@ -31149,7 +31166,7 @@ async function runCommand(commandFn, options) {
 	} catch (e$1) {
 		if (e$1 instanceof Error) M.error(e$1.stack ?? e$1.message);
 		else M.error(String(e$1));
-		process.exit(1);
+		throw new CLIExitError(1);
 	}
 }
 
@@ -38090,6 +38107,7 @@ async function createInteractive(options) {
 		description: result.description || void 0,
 		projectPath: result.projectPath,
 		deploy: options.deploy,
+		skills: options.skills,
 		isInteractive: true
 	});
 }
@@ -38100,10 +38118,11 @@ async function createNonInteractive(options) {
 		description: options.description,
 		projectPath: options.path,
 		deploy: options.deploy,
+		skills: options.skills,
 		isInteractive: false
 	});
 }
-async function executeCreate({ template, name: rawName, description, projectPath, deploy, isInteractive }) {
+async function executeCreate({ template, name: rawName, description, projectPath, deploy, skills, isInteractive }) {
 	const name$1 = rawName.trim();
 	const resolvedPath = resolve(projectPath);
 	const { projectId } = await runTask("Setting up your project...", async () => {
@@ -38163,12 +38182,31 @@ async function executeCreate({ template, name: rawName, description, projectPath
 			finalAppUrl = appUrl;
 		}
 	}
+	let shouldAddSkills = false;
+	if (isInteractive) {
+		const result = await ye({ message: "Add AI agent skills?" });
+		shouldAddSkills = !pD(result) && result;
+	} else shouldAddSkills = !!skills;
+	if (shouldAddSkills) await runTask("Installing AI agent skills...", async () => {
+		await execa("npx", [
+			"-y",
+			"add-skill",
+			"base44/skills",
+			"-y"
+		], {
+			cwd: resolvedPath,
+			stdio: "inherit"
+		});
+	}, {
+		successMessage: theme.colors.base44Orange("AI agent skills added successfully"),
+		errorMessage: "Failed to add AI agent skills - you can add them later with: npx add-skill base44/skills"
+	});
 	M.message(`${theme.styles.header("Project")}: ${theme.colors.base44Orange(name$1)}`);
 	M.message(`${theme.styles.header("Dashboard")}: ${theme.colors.links(getDashboardUrl(projectId))}`);
 	if (finalAppUrl) M.message(`${theme.styles.header("Site")}: ${theme.colors.links(finalAppUrl)}`);
 	return { outroMessage: "Your project is set up and ready to use" };
 }
-const createCommand = new Command("create").description("Create a new Base44 project").option("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("-p, --path <path>", "Path where to create the project").option("-t, --template <id>", "Template ID (e.g., backend-only, backend-and-client)").option("--deploy", "Build and deploy the site").hook("preAction", validateNonInteractiveFlags$1).action(async (options) => {
+const createCommand = new Command("create").description("Create a new Base44 project").option("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("-p, --path <path>", "Path where to create the project").option("-t, --template <id>", "Template ID (e.g., backend-only, backend-and-client)").option("--deploy", "Build and deploy the site").option("--skills", "Add AI agent skills").hook("preAction", validateNonInteractiveFlags$1).action(async (options) => {
 	await chooseCreate(options);
 });
 
@@ -38754,9 +38792,8 @@ const deployCommand = new Command("deploy").description("Deploy all project reso
 //#endregion
 //#region src/cli/commands/project/link.ts
 function validateNonInteractiveFlags(command) {
-	const { create: create$1, name: name$1, existing, projectId } = command.opts();
-	if (create$1 && existing) command.error("--create and --existing cannot be used together");
-	if (existing && !projectId) command.error("--projectId is required when using --existing");
+	const { create: create$1, name: name$1, projectId } = command.opts();
+	if (create$1 && projectId) command.error("--create and --projectId cannot be used together");
 	if (create$1 && !name$1) command.error("--name is required when using --create");
 }
 async function promptForLinkAction() {
@@ -38820,14 +38857,18 @@ async function link(options) {
 	if (!projectRoot) throw new Error("No Base44 project found. Run this command from a project directory with a config.jsonc file.");
 	if (await appConfigExists(projectRoot.root)) throw new Error("Project is already linked. An .app.jsonc file with the appId already exists.");
 	let finalProjectId;
-	const action = options.existing ? "choose" : options.create ? "create" : await promptForLinkAction();
+	const action = options.projectId ? "choose" : options.create ? "create" : await promptForLinkAction();
 	if (action === "choose") {
 		const linkableProjects = (await runTask("Fetching projects...", async () => listProjects(), {
 			successMessage: "Projects fetched",
 			errorMessage: "Failed to fetch projects"
 		})).filter((p$1) => p$1.isManagedSourceCode !== true);
 		if (!linkableProjects.length) return { outroMessage: "No projects available for linking" };
-		const { id: projectId } = options.existing ? { id: options.projectId } : await promptForExistingProject(linkableProjects);
+		let projectId;
+		if (options.projectId) {
+			if (!linkableProjects.find((p$1) => p$1.id === options.projectId)) throw new Error(`Project with ID "${options.projectId}" not found or not available for linking.`);
+			projectId = options.projectId;
+		} else projectId = (await promptForExistingProject(linkableProjects)).id;
 		await runTask("Linking project...", async () => {
 			await writeAppConfig(projectRoot.root, projectId);
 			setAppConfig({
@@ -38861,7 +38902,7 @@ async function link(options) {
 	M.message(`${theme.styles.header("Dashboard")}: ${theme.colors.links(getDashboardUrl(finalProjectId))}`);
 	return { outroMessage: "Project linked" };
 }
-const linkCommand = new Command("link").description("Link a local project to a Base44 project (create new or link existing)").option("-c, --create", "Create a new project (skip selection prompt)").option("-n, --name <name>", "Project name (required when --create is used)").option("-d, --description <description>", "Project description").option("-e, --existing", "Link to an existing project (skip selection prompt)").option("-p, --projectId <id>", "Project ID (required when --existing is used)").hook("preAction", validateNonInteractiveFlags).action(async (options) => {
+const linkCommand = new Command("link").description("Link a local project to a Base44 project (create new or link existing)").option("-c, --create", "Create a new project (skip selection prompt)").option("-n, --name <name>", "Project name (required when --create is used)").option("-d, --description <description>", "Project description").option("-p, --projectId <id>", "Project ID to link to an existing project (skips selection prompt)").hook("preAction", validateNonInteractiveFlags).action(async (options) => {
 	await runCommand(() => link(options), {
 		requireAuth: true,
 		requireAppConfig: false
@@ -38891,10 +38932,10 @@ const siteDeployCommand = new Command("site").description("Manage site deploymen
 
 //#endregion
 //#region package.json
-var version = "0.0.16";
+var version = "0.0.18";
 
 //#endregion
-//#region src/cli/index.ts
+//#region src/cli/program.ts
 const program = new Command();
 program.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(version);
 program.configureHelp({ sortSubcommands: true });
@@ -38908,7 +38949,6 @@ program.addCommand(linkCommand);
 program.addCommand(entitiesPushCommand);
 program.addCommand(functionsDeployCommand);
 program.addCommand(siteDeployCommand);
-program.parse();
 
 //#endregion
-export {  };
+export { CLIExitError, program };

package/package.json

@@ -1,21 +1,20 @@
 {
   "name": "base44",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "Base44 CLI - Unified interface for managing Base44 applications",
   "type": "module",
-  "main": "./dist/cli/index.js",
-  "bin": "./dist/cli/index.js",
-  "exports": {
-    ".": "./dist/cli/index.js"
+  "bin": {
+    "base44": "./bin/run.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "scripts": {
     "build": "tsdown",
     "typecheck": "tsc --noEmit",
-    "dev": "tsx src/cli/index.ts",
-    "start": "node dist/cli/index.js",
+    "dev": "./bin/dev.js",
+    "start": "./bin/run.js",
     "clean": "rm -rf dist",
     "lint": "eslint src",
     "test": "vitest run",