@base44-preview/cli 0.0.56-pr.547.491311d → 0.0.56-pr.547.6723c69
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 +24 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -72,6 +72,30 @@ The CLI will guide you through project setup. For step-by-step tutorials, see th
|
|
|
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 list-directory src --app-id app_123 --json | jq '.entries'
|
|
96
|
+
base44 sandbox run-command "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.
|