@base44-preview/cli 0.0.57-pr.551.ad8dd1c → 0.1.0-pr.551.d451f39
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -0
- package/dist/cli/index.js +737 -268
- package/dist/cli/index.js.map +28 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -53,6 +53,7 @@ The CLI will guide you through project setup. For step-by-step tutorials, see th
|
|
|
53
53
|
| [`whoami`](https://docs.base44.com/developers/references/cli/commands/whoami) | Display the current authenticated user |
|
|
54
54
|
| [`agents pull`](https://docs.base44.com/developers/references/cli/commands/agents-pull) | Pull agents from Base44 to local files |
|
|
55
55
|
| [`agents push`](https://docs.base44.com/developers/references/cli/commands/agents-push) | Push local agents to Base44 |
|
|
56
|
+
| [`connectors initiate`](https://docs.base44.com/developers/references/cli/commands/connectors-initiate) | Initialize a connector on an app and start its OAuth flow |
|
|
56
57
|
| [`connectors pull`](https://docs.base44.com/developers/references/cli/commands/connectors-pull) | Pull connectors from Base44 to local files |
|
|
57
58
|
| [`connectors push`](https://docs.base44.com/developers/references/cli/commands/connectors-push) | Push local connectors to Base44 |
|
|
58
59
|
| [`entities push`](https://docs.base44.com/developers/references/cli/commands/entities-push) | Push local entities to Base44 |
|
|
@@ -60,10 +61,41 @@ The CLI will guide you through project setup. For step-by-step tutorials, see th
|
|
|
60
61
|
| [`secrets list`](https://docs.base44.com/developers/references/cli/commands/secrets-list) | List project secret names |
|
|
61
62
|
| [`secrets set`](https://docs.base44.com/developers/references/cli/commands/secrets-set) | Set one or more project secrets |
|
|
62
63
|
| [`secrets delete`](https://docs.base44.com/developers/references/cli/commands/secrets-delete) | Delete a project secret |
|
|
64
|
+
| [`sandbox ls`](https://docs.base44.com/developers/references/cli/commands/sandbox-ls) | List directory entries in an app's remote sandbox |
|
|
65
|
+
| [`sandbox read`](https://docs.base44.com/developers/references/cli/commands/sandbox-read) | Read file contents from an app's remote sandbox |
|
|
66
|
+
| [`sandbox write`](https://docs.base44.com/developers/references/cli/commands/sandbox-write) | Create or overwrite a file in an app's remote sandbox |
|
|
67
|
+
| [`sandbox edit`](https://docs.base44.com/developers/references/cli/commands/sandbox-edit) | Apply exact old→new string edits to a file in the sandbox |
|
|
68
|
+
| [`sandbox grep`](https://docs.base44.com/developers/references/cli/commands/sandbox-grep) | Search files for a pattern in an app's remote sandbox |
|
|
69
|
+
| [`sandbox run`](https://docs.base44.com/developers/references/cli/commands/sandbox-run) | Run a shell command in an app's remote sandbox |
|
|
70
|
+
| [`sandbox checkpoint`](https://docs.base44.com/developers/references/cli/commands/sandbox-checkpoint) | Create a restore-point checkpoint of an app's remote sandbox |
|
|
63
71
|
| [`site deploy`](https://docs.base44.com/developers/references/cli/commands/site-deploy) | Deploy built site files to Base44 hosting |
|
|
64
72
|
| [`site open`](https://docs.base44.com/developers/references/cli/commands/site-open) | Open the published site in your browser |
|
|
65
73
|
| [`types generate`](https://docs.base44.com/developers/references/cli/commands/types-generate) | Generate TypeScript types from project resources |
|
|
66
74
|
|
|
75
|
+
## Global flags
|
|
76
|
+
|
|
77
|
+
These work with any command:
|
|
78
|
+
|
|
79
|
+
| Flag | Description |
|
|
80
|
+
| ---- | ----------- |
|
|
81
|
+
| `--app-id <id>` | Target a Base44 app explicitly (overrides the linked project and `BASE44_APP_ID`) |
|
|
82
|
+
| `--json` | Emit machine-readable JSON to stdout and run in silent mode |
|
|
83
|
+
|
|
84
|
+
### `--json`
|
|
85
|
+
|
|
86
|
+
Use `--json` for scripting and agent automation:
|
|
87
|
+
|
|
88
|
+
- **stdout is a single JSON document** — pipe it straight into `jq`.
|
|
89
|
+
- **Silent mode** — interactive prompts, the spinner, and human status lines are suppressed; all status and diagnostics go to **stderr**, so stdout stays pure JSON.
|
|
90
|
+
- **Errors are JSON too** — a failure prints `{ "error": "...", "code": "...", "hints": [...] }` to stdout and exits non-zero, so you can parse success and failure from the same stream.
|
|
91
|
+
- **Every command accepts it.** Commands with structured output (e.g. `sandbox`, `connectors`) return rich JSON; others fall back to `{ "output": "<status>" }`.
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# Pure JSON on stdout, ready for jq
|
|
95
|
+
base44 sandbox ls src --app-id app_123 --json | jq '.entries'
|
|
96
|
+
base44 sandbox run "npm test" --app-id app_123 --json | jq '.exitCode'
|
|
97
|
+
```
|
|
98
|
+
|
|
67
99
|
## AI agent skills
|
|
68
100
|
|
|
69
101
|
When creating a project, [base44/skills](https://github.com/base44/skills) are automatically installed. These help AI agents understand how to work with Base44 projects.
|