From 25f3fc1e7de0002cc1ec6778935cf3cc1c36ef6f Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Mon, 9 Feb 2026 19:25:18 +0000 Subject: [PATCH] Update base44-cli skill to v0.0.30 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Synchronized base44-cli skill documentation with CLI source v0.0.30. Changes: - Updated dashboard command syntax: 'base44 dashboard' → 'base44 dashboard open' - Added new 'base44 site open' command reference - Added new 'base44 types generate' command reference (hidden command) - Updated CLI_VERSION from v0.0.26 to v0.0.30 - Fixed agent schema example in SKILL.md (entity_name: "Task" in PascalCase) Breaking Changes: - Dashboard command now requires 'open' subcommand New Commands: - site open: Opens deployed site in browser - types generate: Generates TypeScript types from entities/functions/agents Co-Authored-By: Claude Sonnet 4.5 --- CLI_VERSION | 2 +- skills/base44-cli/SKILL.md | 15 +++- skills/base44-cli/references/dashboard.md | 6 +- skills/base44-cli/references/site-open.md | 52 +++++++++++++ .../base44-cli/references/types-generate.md | 78 +++++++++++++++++++ 5 files changed, 146 insertions(+), 7 deletions(-) create mode 100644 skills/base44-cli/references/site-open.md create mode 100644 skills/base44-cli/references/types-generate.md diff --git a/CLI_VERSION b/CLI_VERSION index 08692e0..5d60b2e 100644 --- a/CLI_VERSION +++ b/CLI_VERSION @@ -1 +1 @@ -v0.0.26 +v0.0.30 diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 549634b..4cfa50e 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -188,7 +188,7 @@ npx base44 |---------|-------------|-----------| | `base44 create` | Create a new Base44 project from a template | [create.md](references/create.md) ⚠️ **MUST READ** | | `base44 link` | Link an existing local project to Base44 | [link.md](references/link.md) | -| `base44 dashboard` | Open the app dashboard in your browser | [dashboard.md](references/dashboard.md) | +| `base44 dashboard open` | Open the app dashboard in your browser | [dashboard.md](references/dashboard.md) | ### Deployment @@ -263,7 +263,7 @@ Agents are conversational AI assistants that can interact with users, access you "instructions": "Detailed instructions for the agent's behavior", "tool_configs": [ // Entity tool - gives agent access to entity operations - { "entity_name": "tasks", "allowed_operations": ["read", "create", "update", "delete"] }, + { "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] }, // Backend function tool - gives agent access to a function { "function_name": "send_email", "description": "Send an email notification" } ], @@ -288,9 +288,18 @@ Agents are conversational AI assistants that can interact with users, access you | Command | Description | Reference | | -------------------- | ----------------------------------------- | ------------------------------------------- | | `base44 site deploy` | Deploy built site files to Base44 hosting | [site-deploy.md](references/site-deploy.md) | +| `base44 site open` | Open the published site in your browser | [site-open.md](references/site-open.md) | **SPA only**: Base44 hosting supports Single Page Applications with a single `index.html` entry point. All routes are served from `index.html` (client-side routing). +### Type Generation + +| Command | Description | Reference | +| ----------------------- | ------------------------------------------------------ | --------------------------------------------------- | +| `base44 types generate` | Generate TypeScript types from project resources | [types-generate.md](references/types-generate.md) | + +**Note:** This command is hidden in the CLI help menu and is for advanced usage. It generates TypeScript declaration files from entities, functions, and agents. + ## Quick Start 1. Install the CLI in your project: @@ -364,7 +373,7 @@ npx base44 site deploy -y ### Opening the Dashboard ```bash # Open app dashboard in browser -npx base44 dashboard +npx base44 dashboard open ``` ## Authentication diff --git a/skills/base44-cli/references/dashboard.md b/skills/base44-cli/references/dashboard.md index 95a534a..09ceeb8 100644 --- a/skills/base44-cli/references/dashboard.md +++ b/skills/base44-cli/references/dashboard.md @@ -1,11 +1,11 @@ -# base44 dashboard +# base44 dashboard open Opens the Base44 app dashboard in your default web browser. ## Syntax ```bash -npx base44 dashboard +npx base44 dashboard open ``` ## Options @@ -21,7 +21,7 @@ This command has no options. ```bash # Open dashboard for current project -npx base44 dashboard +npx base44 dashboard open ``` ## Requirements diff --git a/skills/base44-cli/references/site-open.md b/skills/base44-cli/references/site-open.md new file mode 100644 index 0000000..3464200 --- /dev/null +++ b/skills/base44-cli/references/site-open.md @@ -0,0 +1,52 @@ +# base44 site open + +Open the published site in your default web browser. + +## Syntax + +```bash +npx base44 site open +``` + +## Authentication + +**Required**: Yes. If not authenticated, you'll be prompted to login first. + +## What It Does + +1. Fetches the site URL for your Base44 app +2. Opens the site in your default browser + +## Prerequisites + +- Must be run from a linked Base44 project directory +- Must be authenticated (run `npx base44 login` first) +- Site must have been deployed previously + +## Output + +```bash +$ npx base44 site open + +Site opened at https://my-app.base44.app +``` + +## Use Cases + +- Quickly preview your deployed site +- Open your site from the command line +- Check the live version after deployment + +## Notes + +- The command opens the current live version of your site +- In CI environments (when `CI` env var is set), the browser won't open but the URL is displayed +- The site URL is the same as the one shown after `base44 site deploy` + +## Related Commands + +| Command | Description | +|---------|-------------| +| `base44 site deploy` | Deploy built site files to Base44 hosting | +| `base44 dashboard open` | Open the app dashboard in your browser | +| `base44 deploy` | Deploy all resources including the site | diff --git a/skills/base44-cli/references/types-generate.md b/skills/base44-cli/references/types-generate.md new file mode 100644 index 0000000..1d692f8 --- /dev/null +++ b/skills/base44-cli/references/types-generate.md @@ -0,0 +1,78 @@ +# base44 types generate + +Generate TypeScript declaration file (types.d.ts) from project resources (entities, functions, and agents). + +## Syntax + +```bash +npx base44 types generate +``` + +## Authentication + +**Required**: No. This command operates on local files only. + +## What It Does + +1. Reads project configuration from `base44/config.jsonc` +2. Reads all entities, functions, and agents from the project +3. Generates TypeScript type definitions in `base44/.types/types.d.ts` +4. Updates `tsconfig.json` to include the generated types (if tsconfig exists) + +## Prerequisites + +- Must be run from a Base44 project directory +- Project must have `base44/config.jsonc` + +## Output + +```bash +$ npx base44 types generate + +Generating types... +✓ Types generated successfully + +Generated base44/.types/types.d.ts and updated tsconfig.json +``` + +If no `tsconfig.json` is found: +```bash +$ npx base44 types generate + +Generating types... +✓ Types generated successfully + +Generated base44/.types/types.d.ts +``` + +## Generated Types + +The command generates TypeScript type definitions for: + +- **Entity types** - TypeScript interfaces for each entity schema +- **Function types** - Type definitions for backend functions +- **Agent types** - Type definitions for agent configurations + +## Use Cases + +- After creating or modifying entities +- After adding or changing functions +- After modifying agent configurations +- To get TypeScript IntelliSense for Base44 resources +- As part of your development workflow + +## Notes + +- This command is hidden in the CLI help menu (internal/advanced usage) +- The generated types file is located at `base44/.types/types.d.ts` +- If `tsconfig.json` exists, it will be automatically updated to include the types +- Re-run this command whenever you modify entity schemas, functions, or agents +- The command does not require authentication or network access + +## Related Commands + +| Command | Description | +|---------|-------------| +| `base44 entities push` | Push entities to Base44 (triggers remote type generation) | +| `base44 functions deploy` | Deploy functions to Base44 | +| `base44 agents push` | Push agents to Base44 |