@base44-preview/cli 0.0.56-pr.547.a0144b8 → 0.0.56-pr.547.db4783d
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 +30 -6
- package/dist/cli/index.js +199 -97
- package/dist/cli/index.js.map +22 -20
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -61,17 +61,41 @@ The CLI will guide you through project setup. For step-by-step tutorials, see th
|
|
|
61
61
|
| [`secrets list`](https://docs.base44.com/developers/references/cli/commands/secrets-list) | List project secret names |
|
|
62
62
|
| [`secrets set`](https://docs.base44.com/developers/references/cli/commands/secrets-set) | Set one or more project secrets |
|
|
63
63
|
| [`secrets delete`](https://docs.base44.com/developers/references/cli/commands/secrets-delete) | Delete a project secret |
|
|
64
|
-
| [`sandbox
|
|
65
|
-
| [`sandbox read
|
|
66
|
-
| [`sandbox write
|
|
67
|
-
| [`sandbox edit
|
|
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
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
|
|
70
|
-
| [`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 |
|
|
71
71
|
| [`site deploy`](https://docs.base44.com/developers/references/cli/commands/site-deploy) | Deploy built site files to Base44 hosting |
|
|
72
72
|
| [`site open`](https://docs.base44.com/developers/references/cli/commands/site-open) | Open the published site in your browser |
|
|
73
73
|
| [`types generate`](https://docs.base44.com/developers/references/cli/commands/types-generate) | Generate TypeScript types from project resources |
|
|
74
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
|
+
|
|
75
99
|
## AI agent skills
|
|
76
100
|
|
|
77
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.
|