From bd3a168ddf52d2249087c312b49f721d86c6eb22 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 09:14:29 +0000 Subject: [PATCH] Update base44-cli skill to v0.0.42 - Bump CLI_VERSION from v0.0.35-6-g0f89a25 to v0.0.42 - Add new reference: dev.md (local development server command) - Add new reference: connectors-list-available.md (list OAuth integration types) - Update connectors-push.md: add Provisioned and Skipped status meanings - Update project-logs.md: add --json flag documentation - Update SKILL.md: add base44 dev and connectors list-available to command tables Co-Authored-By: Claude Sonnet 4.6 --- CLI_VERSION | 2 +- skills/base44-cli/SKILL.md | 12 ++-- .../references/connectors-list-available.md | 64 +++++++++++++++++++ .../base44-cli/references/connectors-push.md | 4 +- skills/base44-cli/references/dev.md | 55 ++++++++++++++++ .../references/project-logs.md | 8 +++ 6 files changed, 138 insertions(+), 7 deletions(-) create mode 100644 skills/base44-cli/references/connectors-list-available.md create mode 100644 skills/base44-cli/references/dev.md diff --git a/CLI_VERSION b/CLI_VERSION index 1ff8782..bff119b 100644 --- a/CLI_VERSION +++ b/CLI_VERSION @@ -1 +1 @@ -v0.0.35-6-g0f89a25 +v0.0.42 diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 57de04f..af8aabc 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -199,6 +199,7 @@ npx base44 | `base44 link` | Link an existing local project to Base44 | [link.md](references/link.md) | | `base44 eject` | Download the code for an existing Base44 project | [eject.md](references/eject.md) | | `base44 dashboard open` | Open the app dashboard in your browser | [dashboard.md](references/dashboard.md) | +| `base44 dev` | Start the local development server for backend functions | [dev.md](references/dev.md) | ### Deployment @@ -298,11 +299,12 @@ Agents are conversational AI assistants that can interact with users, access you Connectors are OAuth integrations that let your app connect to external services (Google Calendar, Slack, Notion, etc.). They provide access tokens that you can use in backend functions to call external APIs. -| Action / Command | Description | Reference | -| --------------------------- | ----------------------------------------------- | ----------------------------------------------------- | -| Create Connectors | Define connectors in `base44/connectors` folder | [connectors-create.md](references/connectors-create.md) | -| `base44 connectors pull` | Pull remote connectors to local files | [connectors-pull.md](references/connectors-pull.md) | -| `base44 connectors push` | Push local connectors to Base44 | [connectors-push.md](references/connectors-push.md) | +| Action / Command | Description | Reference | +| --------------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------- | +| Create Connectors | Define connectors in `base44/connectors` folder | [connectors-create.md](references/connectors-create.md) | +| `base44 connectors list-available` | List all available OAuth integration types | [connectors-list-available.md](references/connectors-list-available.md) | +| `base44 connectors pull` | Pull remote connectors to local files | [connectors-pull.md](references/connectors-pull.md) | +| `base44 connectors push` | Push local connectors to Base44 | [connectors-push.md](references/connectors-push.md) | **Note:** Connector commands perform full synchronization - pushing replaces all remote connectors with local ones (and triggers OAuth for new ones), and pulling replaces all local connectors with remote ones. diff --git a/skills/base44-cli/references/connectors-list-available.md b/skills/base44-cli/references/connectors-list-available.md new file mode 100644 index 0000000..6301f52 --- /dev/null +++ b/skills/base44-cli/references/connectors-list-available.md @@ -0,0 +1,64 @@ +# base44 connectors list-available + +List all available OAuth integration types that can be used as connectors in Base44. + +## Syntax + +```bash +npx base44 connectors list-available +``` + +## Options + +No options. The command takes no arguments or flags. + +## Authentication + +**Required**: Yes. If not authenticated, you'll be prompted to login first. + +## What It Does + +1. Fetches all available integration types from Base44 +2. Displays each integration with its type identifier and metadata + +## Example + +```bash +npx base44 connectors list-available +``` + +## Output + +```bash +Google Calendar + type: googlecalendar + ... + +Slack + type: slack + ... + +Notion + type: notion + ... + +Found 12 available integrations. +``` + +## Use Cases + +- Discover which integration types are supported before creating a connector file +- Find the exact `type` value to use in your connector `.jsonc` file +- Check what OAuth integrations are available on the platform + +## Notes + +- The `type` field shown in the output is the value to use in your `base44/connectors/{type}.jsonc` file +- Use `base44 connectors push` to push connector configurations to Base44 +- Use `base44 connectors pull` to pull existing connector configurations from Base44 + +## Related Commands + +- [connectors-create.md](connectors-create.md) - How to create connector configuration files +- [connectors-push.md](connectors-push.md) - Push local connectors to Base44 +- [connectors-pull.md](connectors-pull.md) - Pull connectors from Base44 to local files diff --git a/skills/base44-cli/references/connectors-push.md b/skills/base44-cli/references/connectors-push.md index d94b353..b622f2c 100644 --- a/skills/base44-cli/references/connectors-push.md +++ b/skills/base44-cli/references/connectors-push.md @@ -103,8 +103,10 @@ Run the command again when you're ready to authorize. |--------|---------| | Synced | Connector already existed, scopes updated if needed | | Added | New connector successfully authorized | +| Provisioned | Stripe sandbox was provisioned (special case for `stripe` connector) | | Removed | Connector was deleted from Base44 (not in local files) | -| Failed | Authorization timed out, failed, or was skipped | +| Skipped | Authorization was skipped by user | +| Failed | Authorization timed out, failed, or was not completed | ## Troubleshooting diff --git a/skills/base44-cli/references/dev.md b/skills/base44-cli/references/dev.md new file mode 100644 index 0000000..f1662f8 --- /dev/null +++ b/skills/base44-cli/references/dev.md @@ -0,0 +1,55 @@ +# base44 dev + +Start the local Base44 development server for testing backend functions locally. + +## 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, project settings) +2. Starts a local development server using Deno +3. Serves your backend functions locally for testing + +## Examples + +```bash +# Start dev server on default port +npx base44 dev + +# Start dev server on a specific port +npx base44 dev -p 3001 +``` + +## Output + +```bash +$ npx base44 dev + +Dev server is available at http://localhost:3000 +``` + +## Requirements + +- Must be run from a Base44 project directory +- Project must have backend functions defined in `base44/functions/` + +## Notes + +- The dev server runs functions locally so you can test them without deploying +- The port defaults to an automatically selected available port if not specified +- Use `Ctrl+C` to stop the dev server +- After testing locally, use `npx base44 functions deploy` to deploy functions to Base44 diff --git a/skills/base44-troubleshooter/references/project-logs.md b/skills/base44-troubleshooter/references/project-logs.md index b58fa2a..c421d50 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 array instead of formatted text | 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 scripting or piping to jq) +npx base44 logs --json + +# JSON output for a specific function filtered by level +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`). +- The `--json` flag outputs a JSON array with `time`, `level`, `message`, and `source` fields per entry.