@base44-preview/cli 0.0.17-pr.19.537d5c2 → 0.0.17-pr.19.61c6117

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 --projectId <app-id>
+# Create a project
+base44 create
 ```
 
-| Option | Description |
-|--------|-------------|
-| `-c, --create` | Create a new project (skip selection prompt) |
-| `-n, --name <name>` | Project name (required with --create) |
-| `-d, --description <desc>` | Project description (optional) |
-| `-p, --projectId <id>` | Link to an existing project by ID (skips selection prompt) |
+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

@@ -1,20 +1,12 @@
 #!/usr/bin/env tsx
-import { program, CLIExitError } from '../src/cli/program.ts';
+import { program, CLIExitError } from "../src/cli/index.ts";
 
 try {
   await program.parseAsync();
-} catch (e) {
-  if (e instanceof CLIExitError) {
-    process.exit(e.code);  // Clean exit, no stack trace
+} catch (error) {
+  if (error instanceof CLIExitError) {
+    process.exit(error.code);
   }
-  // Commander throws for --help and --version with exitCode 0
-  if (e?.code === 'commander.helpDisplayed' || e?.code === 'commander.version') {
-    process.exit(0);
-  }
-  // For other Commander errors, exit with the provided code
-  if (e?.exitCode !== undefined) {
-    process.exit(e.exitCode);
-  }
-  console.error(e);
+  console.error(error);
   process.exit(1);
 }

package/bin/run.js

@@ -1,20 +1,12 @@
 #!/usr/bin/env node
-import { program, CLIExitError } from '../dist/program.js';
+import { program, CLIExitError } from "../dist/index.js";
 
 try {
   await program.parseAsync();
-} catch (e) {
-  if (e instanceof CLIExitError) {
-    process.exit(e.code);  // Clean exit, no stack trace
+} catch (error) {
+  if (error instanceof CLIExitError) {
+    process.exit(error.code);
   }
-  // Commander throws for --help and --version with exitCode 0
-  if (e?.code === 'commander.helpDisplayed' || e?.code === 'commander.version') {
-    process.exit(0);
-  }
-  // For other Commander errors, exit with the provided code
-  if (e?.exitCode !== undefined) {
-    process.exit(e.exitCode);
-  }
-  console.error(e);
+  console.error(error);
   process.exit(1);
 }

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

@@ -30605,6 +30605,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;
@@ -38051,6 +38066,13 @@ var require_lodash = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#region src/cli/commands/project/create.ts
 var import_lodash = /* @__PURE__ */ __toESM(require_lodash(), 1);
 const DEFAULT_TEMPLATE_ID = "backend-only";
+const SUPPORTED_AGENTS = [{
+	value: "cursor",
+	label: "Cursor"
+}, {
+	value: "claude-code",
+	label: "Claude Code"
+}];
 async function getTemplateById(templateId) {
 	const templates = await listTemplates();
 	const template = templates.find((t) => t.id === templateId);
@@ -38113,6 +38135,7 @@ async function createInteractive(options) {
 		description: result.description || void 0,
 		projectPath: result.projectPath,
 		deploy: options.deploy,
+		skills: options.skills,
 		isInteractive: true
 	});
 }
@@ -38123,10 +38146,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 () => {
@@ -38186,12 +38210,45 @@ async function executeCreate({ template, name: rawName, description, projectPath
 			finalAppUrl = appUrl;
 		}
 	}
+	let selectedAgents = [];
+	if (isInteractive) {
+		const result = await fe({
+			message: "Add AI agent skills? (Select agents to configure)",
+			options: SUPPORTED_AGENTS,
+			initialValues: SUPPORTED_AGENTS.map((agent) => agent.value),
+			required: false
+		});
+		if (!pD(result)) selectedAgents = result;
+	} else if (skills) selectedAgents = SUPPORTED_AGENTS.map((agent) => agent.value);
+	if (selectedAgents.length > 0) {
+		const agentArgs = selectedAgents.flatMap((agent) => ["-a", agent]);
+		M.step(`Installing skills for: ${selectedAgents.join(", ")}`);
+		await runTask(`Installing skills for: ${selectedAgents.join(", ")}`, async () => {
+			await execa("npx", [
+				"-y",
+				"add-skill",
+				"base44/skills",
+				"-y",
+				"-s",
+				"base44-cli",
+				"-s",
+				"base44-sdk",
+				...agentArgs
+			], {
+				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 (Cursor, Claude Code)").hook("preAction", validateNonInteractiveFlags$1).action(async (options) => {
 	await chooseCreate(options);
 });
 
@@ -38921,46 +38978,19 @@ var version = "0.0.17";
 
 //#endregion
 //#region src/cli/program.ts
-/**
-* Custom error class for CLI exit codes.
-* Thrown instead of calling process.exit() directly to allow testing.
-* The bin/run.js entry point catches this and calls process.exit().
-*/
-var CLIExitError = class extends Error {
-	constructor(code$1) {
-		super(`CLI exited with code ${code$1}`);
-		this.code = code$1;
-		this.name = "CLIExitError";
-	}
-};
-/**
-* Creates a new Commander program instance with all commands registered.
-* Use this factory for testing to get a fresh program instance per test.
-*/
-function createProgram() {
-	const program$2 = new Command();
-	program$2.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(version);
-	program$2.configureHelp({ sortSubcommands: true });
-	program$2.exitOverride((err) => {
-		throw err;
-	});
-	program$2.configureOutput({
-		writeOut: (str) => process.stdout.write(str),
-		writeErr: (str) => process.stderr.write(str)
-	});
-	program$2.addCommand(loginCommand);
-	program$2.addCommand(whoamiCommand);
-	program$2.addCommand(logoutCommand);
-	program$2.addCommand(createCommand);
-	program$2.addCommand(dashboardCommand);
-	program$2.addCommand(deployCommand);
-	program$2.addCommand(linkCommand);
-	program$2.addCommand(entitiesPushCommand);
-	program$2.addCommand(functionsDeployCommand);
-	program$2.addCommand(siteDeployCommand);
-	return program$2;
-}
-const program = createProgram();
-
-//#endregion
-export { CLIExitError, createProgram, program };
+const program = new Command();
+program.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(version);
+program.configureHelp({ sortSubcommands: true });
+program.addCommand(loginCommand);
+program.addCommand(whoamiCommand);
+program.addCommand(logoutCommand);
+program.addCommand(createCommand);
+program.addCommand(dashboardCommand);
+program.addCommand(deployCommand);
+program.addCommand(linkCommand);
+program.addCommand(entitiesPushCommand);
+program.addCommand(functionsDeployCommand);
+program.addCommand(siteDeployCommand);
+
+//#endregion
+export { CLIExitError, program };

package/package.json

@@ -1,15 +1,11 @@
 {
   "name": "@base44-preview/cli",
-  "version": "0.0.17-pr.19.537d5c2",
+  "version": "0.0.17-pr.19.61c6117",
   "description": "Base44 CLI - Unified interface for managing Base44 applications",
   "type": "module",
-  "main": "./dist/program.js",
   "bin": {
     "base44": "./bin/run.js"
   },
-  "exports": {
-    ".": "./dist/program.js"
-  },
   "files": [
     "dist",
     "bin"
@@ -71,5 +67,8 @@
   },
   "engines": {
     "node": ">=20.19.0"
+  },
+  "optionalDependencies": {
+    "@rollup/rollup-linux-x64-gnu": "^4.56.0"
   }
 }