Command reference

Command overview

Command	Alias	Description
action create	a,actions c	Generate a custom workflow action.
analyze	an	Analyze app to check for valid app configurations, security issues and bundle statistics.
build	b	Build the app and analyzes the bundle.
create	c	Create new Dynatrace app.
default		Output basic information about the App Toolkit.
deploy	de	Deploy the app to the selected environment or the 'dev' channel of linked project.
dev	d	Start the development server.
function create	f,functions c	Create an app function.
generate action	g a	Generate a custom workflow action.
generate function	g f	Generate an app function.
info	i	Output detailed information about the App Toolkit and the environment.
uninstall	un	Uninstall the app from the specified environment.
update	u	Update @dynatrace-scoped packages and the App Toolkit to the latest version and apply automatic migrations.
version	v	Print the version of the App Toolkit.
help		Display a set of dt-app commands with a description.

dt-app action create

Generate a custom workflow action.

Arguments

Argument	Description
[name]	The name of the action.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--skip-tests	Do not generate test files.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app analyze

Analyze app to check for valid app configurations, security issues and bundle statistics.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app build

Build the app and analyzes the bundle.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--no-prod	Build in development mode.
--no-sdk-injection	Disable the automatic injection of the Dynatrace SDK.
--no-type-check	Skip type checking.
--prod	Build in production mode. Per default the build always gets executed in production mode.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app create

Create new Dynatrace app.

Arguments

Argument	Description
[name]	The name of the app.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--environment-url <name>	Specify your environment.
--no-embedded-templates	Specify whether the templates embedded with the CLI or the ones downloaded from an external source should be used.
--no-git	Do not initialize a git repository.
--oauth-client-id <id>	Specify the single sign-on client ID.
--package-manager [name]	Specify your package manager.
--skip-install	Do not install dependencies after initialization.
--skip-repository-check	Skip the safety check whether the project is generated inside an existing repository for headless execution.
--template [name]	Choose the template to generate the app from.
--template-dir <dir>	Specify the directory that contains the template your app should be created from.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app default

Output basic information about the App Toolkit.

Options

Option	Description
-v, --version	Print the version of the App Toolkit.

dt-app deploy

Deploy the app to the selected environment or the 'dev' channel of linked project.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not actually deploy the app only perform a dry run.
--environment-url [url]	The environment that should be used.
--no-type-check	Skip type checking.
--sign-archive	Sign the archive that will be deployed. If you need to specify a different signing endpoint, set the appropriate environment variables. For more details, refer to the Environment Variables section.
--skip-build	Skip the build before deploying.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%".

dt-app dev

Start the development server.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--environment-url [url]	The environment that should be used.
--host [name]	The host IP to bind the dev server on.
--no-live-reload	Disable file watching and browser live reloading
--no-open	Do not open the browser with the dev server.
--no-sdk-injection	Disable automatic injection of the Dynatrace SDK.
--no-type-check	Skip type checking.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"
-o, --open	Open the browser with the dev server.
-p, --port <number>	The port where the files should be served.
-w, --show-warnings	Display build warnings.

dt-app function create

Create an app function.

Arguments

Argument	Description
[name]	The name of the function.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--generate-tests	Generate test files for functions without tests.
--skip-tests	Do not generate test files.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app generate action

Generate a custom workflow action.

Arguments

Argument	Description
[name]	The name of the action.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--skip-tests	Do not generate test files.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app generate function

Generate an app function.

Arguments

Argument	Description
[name]	The name of the function.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--generate-tests	Generate test files for functions without tests.
--skip-tests	Do not generate test files.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app info

Output detailed information about the App Toolkit and the environment.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app uninstall

Uninstall the app from the specified environment.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not actually remove the app only perform a dry run.
--environment-url [url]	The environment that should be used.
--global	Remove the app in the global context.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app update

Update @dynatrace-scoped packages and the App Toolkit to the latest version and apply automatic migrations.

Arguments

Argument	Description
[packages...]	The packages that should be updated.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--skip-install	Do not install dependencies after migrations.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"
--yes	Update all outdated packages without prompt for confirmation.
-i, --interactive	Choose the packages you want to update manually.

dt-app version

Print the version of the App Toolkit.

dt-app help

Display a set of dt-app commands with a description.