Global flags
Use global flags to control CLI behavior consistently across commands, especially for telemetry and machine-readable output.
Global flag capabilities
| Capability | What it gives you |
|---|---|
| Telemetry control | Disable telemetry for one command execution when needed |
| AI/help formatting | Return help output in readable or structured formats |
| Cross-command consistency | Apply the same control flags to create, dev, start, preview, and build |
Global options
| Flag | Description | Default |
|---|---|---|
--no-telemetry |
Disable anonymous telemetry for a single command execution. | telemetry enabled |
--ai-help |
Show AI-assistant oriented help output. | disabled |
--format <pretty|json> |
Output format used with --ai-help. |
pretty |
Practical examples
Disable telemetry for a CI build
Use this when policy requires explicitly disabling telemetry for specific automation runs.
Generate machine-readable help for tooling
Use this for AI tooling, wrappers, or scripts that parse command help output.
Keep readable help output for local debugging
Use pretty mode when you want assistant-friendly output that still reads well in terminal sessions.
Notes
- Global flags are parsed before command-specific options.
- Telemetry behavior and privacy details are documented in repository
TELEMETRY.md. - Command pages document command-specific flags separately.
- Global flags can be combined with command-specific options.
Next steps
ON THIS PAGE