From 1181fb3b1289806123a70acdd7a7fbcf26ee7f97 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Mon, 9 Mar 2026 09:38:56 +0000 Subject: [PATCH] Update base44-cli skill to main (v0.0.41) - Add new `base44 dev` command reference - Add `--json` flag to logs command documentation - Update non-interactive environment notes across connectors-push, dashboard, site-open, deploy - Bump CLI_VERSION from v0.0.35-6-g0f89a25 to v0.0.41 Co-Authored-By: Claude Sonnet 4.6 --- CLI_VERSION | 2 +- skills/base44-cli/SKILL.md | 1 + .../base44-cli/references/connectors-push.md | 4 +- skills/base44-cli/references/dashboard.md | 2 +- skills/base44-cli/references/deploy.md | 2 +- skills/base44-cli/references/dev.md | 57 +++++++++++++++++++ skills/base44-cli/references/site-open.md | 2 +- .../references/project-logs.md | 8 +++ 8 files changed, 72 insertions(+), 6 deletions(-) create mode 100644 skills/base44-cli/references/dev.md diff --git a/CLI_VERSION b/CLI_VERSION index 1ff8782..ff2cfd8 100644 --- a/CLI_VERSION +++ b/CLI_VERSION @@ -1 +1 @@ -v0.0.35-6-g0f89a25 +v0.0.41 diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 57de04f..a3b71d3 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -205,6 +205,7 @@ npx base44 | Command | Description | Reference | |---------|-------------|-----------| | `base44 deploy` | Deploy all resources (entities, functions, agents, connectors, and site) | [deploy.md](references/deploy.md) | +| `base44 dev` | Start the local development server for testing backend functions | [dev.md](references/dev.md) | ### Entity Management diff --git a/skills/base44-cli/references/connectors-push.md b/skills/base44-cli/references/connectors-push.md index d94b353..dabc5df 100644 --- a/skills/base44-cli/references/connectors-push.md +++ b/skills/base44-cli/references/connectors-push.md @@ -75,9 +75,9 @@ Summary: Removed: slack ``` -## CI/CD Environments +## Non-Interactive Environments -In non-interactive environments (no TTY, such as CI/CD pipelines), the OAuth flow is skipped automatically: +In non-interactive environments (CI/CD pipelines, no TTY), the OAuth flow is skipped automatically: ``` Skipped OAuth in non-interactive mode. Run 'base44 connectors push' locally or open the links above to authorize. diff --git a/skills/base44-cli/references/dashboard.md b/skills/base44-cli/references/dashboard.md index 8340233..4fc5efc 100644 --- a/skills/base44-cli/references/dashboard.md +++ b/skills/base44-cli/references/dashboard.md @@ -42,4 +42,4 @@ Dashboard opened at https://base44.cloud/apps/your-app-id - The dashboard provides a web interface to manage your app's entities, functions, agents, users, and settings - If you're not in a project directory, the command will fail with an error -- The command will not open a browser in CI environments (when `process.env.CI` is set) +- The command will not open a browser in non-interactive environments (CI/CD pipelines or when no TTY is available) diff --git a/skills/base44-cli/references/deploy.md b/skills/base44-cli/references/deploy.md index c7fc925..b4060bf 100644 --- a/skills/base44-cli/references/deploy.md +++ b/skills/base44-cli/references/deploy.md @@ -63,7 +63,7 @@ npx base44 deploy -y ## Connector OAuth Flow -If any connectors require authorization after deployment, the CLI will prompt you to open your browser to complete OAuth. In non-interactive environments (CI/CD, no TTY), OAuth prompts are skipped automatically. +If any connectors require authorization after deployment, the CLI will prompt you to open your browser to complete OAuth. In non-interactive environments (CI/CD, no TTY) or when `-y` is used, OAuth prompts are skipped automatically. ``` Some connectors still require authorization. Run 'base44 connectors push' or open the links above in your browser. diff --git a/skills/base44-cli/references/dev.md b/skills/base44-cli/references/dev.md new file mode 100644 index 0000000..ae06b6b --- /dev/null +++ b/skills/base44-cli/references/dev.md @@ -0,0 +1,57 @@ +# base44 dev + +Start the local development server for testing backend functions. + +## Syntax + +```bash +npx base44 dev [options] +``` + +## Options + +| Option | Description | Required | +|--------|-------------|----------| +| `-p, --port ` | Port for the development server | No | + +## Authentication + +**Required**: Yes. If not authenticated, you'll be prompted to login first. + +## What It Does + +1. Reads project configuration (functions, entities) +2. Starts a local development server using Deno +3. Serves backend functions locally for testing +4. Outputs the URL where the dev server is available + +## Examples + +```bash +# Start dev server on default port +npx base44 dev + +# Start dev server on a specific port +npx base44 dev --port 3001 +npx base44 dev -p 3001 +``` + +## Output + +```bash +$ npx base44 dev + +Dev server is available at http://localhost:3000 +``` + +## Prerequisites + +- Must be run from a Base44 project directory +- Project must have function definitions in `base44/functions/` + +## Notes + +- The dev server runs locally and does not require deployment +- Use this to test backend functions before deploying to Base44 +- If no port is specified, a default port is chosen automatically +- The server uses Deno under the hood for function execution diff --git a/skills/base44-cli/references/site-open.md b/skills/base44-cli/references/site-open.md index b3d5641..d1fd2d4 100644 --- a/skills/base44-cli/references/site-open.md +++ b/skills/base44-cli/references/site-open.md @@ -34,6 +34,6 @@ Site opened at https://my-app.base44.app ## Notes -- The command will not open a browser in CI environments (when `process.env.CI` is set) +- The command will not open a browser in non-interactive environments (CI/CD pipelines or when no TTY is available) - Use this command to quickly view your deployed site - The site URL is also displayed after deploying with `base44 site deploy` or `base44 deploy` diff --git a/skills/base44-troubleshooter/references/project-logs.md b/skills/base44-troubleshooter/references/project-logs.md index b58fa2a..febb1ae 100644 --- a/skills/base44-troubleshooter/references/project-logs.md +++ b/skills/base44-troubleshooter/references/project-logs.md @@ -18,6 +18,7 @@ npx base44 logs [options] | `--level ` | Filter by log level: `log`, `info`, `warn`, `error`, `debug` | No | | `-n, --limit ` | Number of results to return (1-1000, default: 50) | No | | `--order ` | Sort order: `asc` or `desc` (default: `desc`) | No | +| `--json` | Output logs as JSON instead of human-readable format | No | ## Examples @@ -45,6 +46,12 @@ npx base44 logs -n 100 --order asc # Last 10 errors for a specific function npx base44 logs --function myFunction --level error --limit 10 + +# Output logs as JSON (useful for piping to jq or other tools) +npx base44 logs --json + +# JSON output for a specific function +npx base44 logs --function my-function --level error --json ``` ## Notes @@ -55,3 +62,4 @@ npx base44 logs --function myFunction --level error --limit 10 - If `--function` is omitted, logs are fetched for **all functions** defined in `base44/config.jsonc`. - The `--limit` applies after merging logs from all specified functions. - The `--since` and `--until` values are normalized to UTC if no timezone is provided (appends `Z`). +- Use `--json` to get structured output suitable for piping to `jq` or other tools. Each entry has `time`, `level`, `message`, and `source` (function name) fields.