From 9d344e22d6b79284b5a40888320e08836b8a01c7 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 13:35:41 +0000 Subject: [PATCH 1/7] Update base44-cli skill to main March 18, 2026 - Add exec.md reference for new `base44 exec` command (runs scripts via stdin with SDK pre-authenticated) - Add exec command to SKILL.md Available Commands table - Update CLI_VERSION from v0.0.45 to v0.0.45-4-gfb355f8 Co-Authored-By: Claude Sonnet 4.6 --- CLI_VERSION | 2 +- skills/base44-cli/SKILL.md | 6 +++++ skills/base44-cli/references/exec.md | 36 ++++++++++++++++++++++++++++ 3 files changed, 43 insertions(+), 1 deletion(-) create mode 100644 skills/base44-cli/references/exec.md diff --git a/CLI_VERSION b/CLI_VERSION index 5fe386d..a9fc903 100644 --- a/CLI_VERSION +++ b/CLI_VERSION @@ -1 +1 @@ -v0.0.45 +v0.0.45-4-gfb355f8 diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index ac07484..85978ba 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -360,6 +360,12 @@ Manage project secrets (environment variables stored securely in Base44). These | `base44 secrets set` | Set one or more secrets (KEY=VALUE or --env-file) | [secrets-set.md](references/secrets-set.md) | | `base44 secrets delete ` | Delete a secret by name | [secrets-delete.md](references/secrets-delete.md) | +### Script Execution + +| Command | Description | Reference | +|---------|-------------|-----------| +| `base44 exec` | Run a script (via stdin) with the Base44 SDK pre-authenticated | [exec.md](references/exec.md) | + ### Type Generation | Command | Description | Reference | diff --git a/skills/base44-cli/references/exec.md b/skills/base44-cli/references/exec.md new file mode 100644 index 0000000..f125cad --- /dev/null +++ b/skills/base44-cli/references/exec.md @@ -0,0 +1,36 @@ +# base44 exec + +Run a script with the Base44 SDK pre-authenticated as the current user. Reads the script from stdin. + +## Syntax + +```bash +cat ./script.ts | npx base44 exec +echo "" | npx base44 exec +``` + +## How It Works + +The `exec` command reads a script from stdin and runs it server-side with the Base44 SDK pre-authenticated as the currently logged-in user. This allows you to run one-off scripts against your app's data without writing a full function. + +## Examples + +```bash +# Run a script file +cat ./script.ts | npx base44 exec + +# Inline script +echo "const users = await base44.entities.User.list(); console.log(users)" | npx base44 exec +``` + +## Requirements + +- Must be authenticated (`npx base44 login`) +- Must be run from a linked Base44 project directory +- Script must be piped via stdin (non-interactive mode) + +## Notes + +- The script runs with the Base44 SDK pre-authenticated — you can use `base44.entities`, `base44.functions`, etc. directly +- Exit code from the script is forwarded as the CLI process exit code +- This command requires stdin to be piped (it does not accept input in interactive TTY mode) From 818a71b7ea5922300ac636876ce9790ba590520b Mon Sep 17 00:00:00 2001 From: Netanel Gilad Date: Wed, 18 Mar 2026 15:59:46 +0200 Subject: [PATCH 2/7] Apply suggestion from @netanelgilad --- CLI_VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLI_VERSION b/CLI_VERSION index a9fc903..5bc7386 100644 --- a/CLI_VERSION +++ b/CLI_VERSION @@ -1 +1 @@ -v0.0.45-4-gfb355f8 +v0.0.46 From 3c47f013fb7361d2a956d0fde95aced3f8e8c1a3 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 14:05:00 +0000 Subject: [PATCH 3/7] Expand exec command description with SDK use cases Co-authored-by: Netanel Gilad --- skills/base44-cli/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 85978ba..190a701 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -366,6 +366,8 @@ Manage project secrets (environment variables stored securely in Base44). These |---------|-------------|-----------| | `base44 exec` | Run a script (via stdin) with the Base44 SDK pre-authenticated | [exec.md](references/exec.md) | +Run one-off scripts against your app with the Base44 SDK pre-authenticated. Use it to perform CRUD operations on entities (`base44.entities.MyEntity.list/create/update/delete`), call backend functions (`base44.functions.myFunction()`), invoke agents, or access any other resource exposed by the SDK — without deploying a full function. Useful for data migrations, bulk operations, debugging, and automation scripts. + ### Type Generation | Command | Description | Reference | From 17f3969eeb380376a5c15189ea75b764c5974a95 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 14:09:43 +0000 Subject: [PATCH 4/7] Fix Script Execution section: move description above table, fix function invoke syntax Co-authored-by: Netanel Gilad --- skills/base44-cli/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 190a701..b5a75ec 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -362,12 +362,12 @@ Manage project secrets (environment variables stored securely in Base44). These ### Script Execution +Run one-off scripts against your app with the Base44 SDK pre-authenticated. Use it to perform CRUD operations on entities (`base44.entities.MyEntity.list/create/update/delete`), call backend functions (`base44.functions.invoke("myFunction", args)`), invoke agents, or access any other resource exposed by the SDK — without deploying a full function. Useful for data migrations, bulk operations, debugging, and automation scripts. + | Command | Description | Reference | |---------|-------------|-----------| | `base44 exec` | Run a script (via stdin) with the Base44 SDK pre-authenticated | [exec.md](references/exec.md) | -Run one-off scripts against your app with the Base44 SDK pre-authenticated. Use it to perform CRUD operations on entities (`base44.entities.MyEntity.list/create/update/delete`), call backend functions (`base44.functions.myFunction()`), invoke agents, or access any other resource exposed by the SDK — without deploying a full function. Useful for data migrations, bulk operations, debugging, and automation scripts. - ### Type Generation | Command | Description | Reference | From 978b4dc4c0e16f24929070a46aa8d7ced79071a7 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 18 Mar 2026 14:11:45 +0000 Subject: [PATCH 5/7] docs: update README to match skills (skill table, install, or links) --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c804e16..a2ae2bf 100644 --- a/README.md +++ b/README.md @@ -39,8 +39,8 @@ npx skills add base44/skills -g | Skill | Description | |-------|-------------| -| [`base44-cli`](skills/base44-cli/SKILL.md) | Create and manage Base44 projects using the CLI. Handles initialization, deployment, entity schema management, and authentication. | -| [`base44-sdk`](skills/base44-sdk/SKILL.md) | Build apps using the Base44 JavaScript SDK. Covers entities, auth, agents, functions, integrations, and connectors. | +| [`base44-cli`](skills/base44-cli/SKILL.md) | Create and manage Base44 projects using the CLI. Handles resource configuration (entities, backend functions, AI agents), initialization, and deployment. | +| [`base44-sdk`](skills/base44-sdk/SKILL.md) | Build apps using the Base44 JavaScript SDK. Communicate with remote resources like entities, backend functions, and AI agents. | | [`base44-troubleshooter`](skills/base44-troubleshooter/SKILL.md) | Troubleshoot production issues using backend function logs. Use when investigating app errors or diagnosing production problems. | ## About Agent Skills From 58495c3da3cb919207c2c34e6ed4a419a230e19b Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 14:16:02 +0000 Subject: [PATCH 6/7] Emphasize base44 as preinitialized global SDK client in exec.md Co-authored-by: Netanel Gilad --- skills/base44-cli/references/exec.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/skills/base44-cli/references/exec.md b/skills/base44-cli/references/exec.md index f125cad..969d322 100644 --- a/skills/base44-cli/references/exec.md +++ b/skills/base44-cli/references/exec.md @@ -13,6 +13,16 @@ echo "" | npx base44 exec The `exec` command reads a script from stdin and runs it server-side with the Base44 SDK pre-authenticated as the currently logged-in user. This allows you to run one-off scripts against your app's data without writing a full function. +## Available Globals + +> **`base44`** — a preinitialized SDK client, available as a global variable in every exec script. You do not need to import or configure it — it is ready to use immediately. + +Use it to interact with your app's resources: + +- `base44.entities.` — CRUD operations on entities (`.list()`, `.get(id)`, `.create(data)`, `.update(id, data)`, `.delete(id)`) +- `base44.functions.invoke(name, data?)` — call a backend function +- `base44.agents.` — invoke AI agents + ## Examples ```bash From 56da48494f9250ae45a52db36c422980b4ba6051 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 14:19:03 +0000 Subject: [PATCH 7/7] Add SDK reference bullet to exec.md globals list Co-authored-by: Netanel Gilad --- skills/base44-cli/references/exec.md | 1 + 1 file changed, 1 insertion(+) diff --git a/skills/base44-cli/references/exec.md b/skills/base44-cli/references/exec.md index 969d322..68b477f 100644 --- a/skills/base44-cli/references/exec.md +++ b/skills/base44-cli/references/exec.md @@ -22,6 +22,7 @@ Use it to interact with your app's resources: - `base44.entities.` — CRUD operations on entities (`.list()`, `.get(id)`, `.create(data)`, `.update(id, data)`, `.delete(id)`) - `base44.functions.invoke(name, data?)` — call a backend function - `base44.agents.` — invoke AI agents +- For more available resources and methods, see the [Base44 SDK reference](../../base44-sdk/SKILL.md) ## Examples