Commands

Reference of elemctl commands and options: common flags, applications, builds, deploy and the rest.

This reference is generated from the tool itself – the same text elemctl --help prints, gathered on one page.

Common flags are accepted in any position – before the command and after it: elemctl --timeout 120 apps list and elemctl apps list --timeout 120 are the same run. The output language follows --lang, the ELEMCTL_LANG variable, or the system locale.

A key whose help says it may be repeated collects every value. Any other key takes one value: the CLI refuses a repetition with a different value before the command runs and lets a repetition with the same value through.

Common flags

Manage 1C:Enterprise.Element platform applications (Console API v2)

usage: elemctl [-h] [--base-url BASE_URL] [--client-id CLIENT_ID] [--client-secret CLIENT_SECRET]
               [--env-file ENV_FILE] [--timeout TIMEOUT] [--lang {ru,en}] [--json] [--quiet]
               [--version]
               command ...

Options

Option	Description
`-h, --help`	show this help message and exit
`--base-url BASE_URL`	platform base URL (ELEMENT_BASE_URL)
`--client-id CLIENT_ID`	Client-Id for obtaining a token (ELEMENT_CLIENT_ID)
`--client-secret CLIENT_SECRET`	the Client-Secret for that Client-Id (ELEMENT_CLIENT_SECRET)
`--env-file ENV_FILE`	path to the .env file (default: .env in the current directory)
`--timeout TIMEOUT`	request timeout in seconds (default 60)
`--lang {ru,en}`	output language (default: env ELEMCTL_LANG / system locale / ru)
`--json`	machine-readable output: stdout carries the JSON answer alone, everything else (progress, warnings, errors) goes to stderr
`--quiet`	print no progress: neither progress lines nor warnings go to stderr, the answer and a failure stay; the form of the answer is the same
`--version`	show the version and exit

Commands

Command	Description
`token`	obtain and print a token
`apps`	applications
`spaces`	spaces
`projects`	projects
`builds`	project assemblies on the platform
`build`	build an assembly archive locally from sources (does not call the platform: the connection options, `--env-file` among them, are refused, and no version number is reserved on the server)
`inspect`	inspect a prebuilt assembly archive (.xasm/.xlib); does not call the platform – the connection options, `--env-file` among them, are refused
`deploy`	full cycle: build -> upload -> apply -> restart -> verify the apply
`user-lists`	user lists and their sign-in settings
`probe`	isolated compilation check: build -> throwaway application -> errors with file and position -> cleanup; the project directory must follow the {repository}/{Vendor}/{Name}/Project.yaml layout a build requires
`verify-deploy`	check that a build really landed on an application: tasks in an error status (they carry the file and position of a compilation error), the applied build compared with the expected one, the address answering; deploys nothing
`branches`	development-environment branches
`dumps`	application dumps
`tasks`	application tasks (the listing – tasks list [`--app-id` ID])
`tech`	technology version
`debug-adapter`	path to the platform debug adapter from the plugin (for the VS Code extension)
`plugins`	elemctl plugin diagnostics (extension points)
`self-update`	update elemctl by unpacking the wheel (safe when the exe is held by the MCP server)
`mcp`	start the MCP server (stdio transport)

`elemctl token`

usage: elemctl token [-h]

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl apps`

usage: elemctl apps [-h] action ...

Arguments

Option	Description
`list`	list applications
`get`	application details; applied-build carries the branch and the commit of the applied build (from the build card or from the local registry of uploads)
`find`	find an application by name (exact, case-insensitive match)
`create`	create an application
`ensure`	create the application if it does not exist yet (idempotent)
`apply`	apply an uploaded assembly to an application and verify that it really landed
`delete`	delete an application (irreversible; the URL changes on re-creation)
`start`	start an application
`stop`	stop an application
`debug`	data for a debug session (debug-token, debug-address)
`users`	the users connected to the application: the user list, the id, the presentation, whether an administrator and whether token access is on (the platform gives no login here)
`token-access`	a user’s access to the HTTP services of the application by a token: show or switch it (without it a call of a service with a token gets a 500 “Token access is denied”)
`export`	save the build the application runs to a file (the extensions are not in it; export-extension saves them)
`export-extension`	save the build of an extension applied to the application to a file (a method of Console API 2.1; a server without it gets a plain refusal)

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl apps list`

usage: elemctl apps list [-h] [--name NAME] [--status STATUS] [--include-deleted] [--brief]

Options

Option	Description
`-h, --help`	show this help message and exit
`--name NAME`	case-insensitive name substring filter (applied client-side)
`--status STATUS`	filter by status (Running, Stopped, Error, Deleted); several of them separated by commas or by repeating the key
`--include-deleted`	list deleted applications too (hidden by default)
`--brief`	brief cards: id, name, status, uri, applied version

`elemctl apps get`

usage: elemctl apps get [-h] [--app-id APP_ID] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps find`

usage: elemctl apps find [-h] [--include-deleted] NAME

Arguments

Option	Description
`NAME`	the application name

Options

Option	Description
`-h, --help`	show this help message and exit
`--include-deleted`	search deleted applications too (skipped by default)

`elemctl apps create`

usage: elemctl apps create [-h] [--project-id PROJECT_ID] [--version-id VERSION_ID]
                           [--latest-build] [--space-id SPACE_ID] [--tech-version TECH_VERSION]
                           [--no-dev-mode] [--wait] [--verify] [--no-verify]
                           NAME

Arguments

Option	Description
`NAME`	the application name

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	source project; with `--version-id` its build list is checked for the source assembly, which the platform may have deleted (default: ELEMENT_PROJECT_ID)
`--version-id VERSION_ID`	id of the source assembly; if the project does not exist yet, create it with ‘builds upload <file>.xasm `--space-id` <id>’ without `--project-id`
`--latest-build`	source: the project’s latest assembly
`--space-id SPACE_ID`	space
`--tech-version TECH_VERSION`	technology version
`--no-dev-mode`	do not create a development environment
`--wait`	wait until the application is ready (and verify the assembly it runs)
`--verify`	verify that the application really runs the requested assembly (implies `--wait`); exit code 1 when it does not
`--no-verify`	do not verify the applied assembly – only wait until ready

`elemctl apps ensure`

usage: elemctl apps ensure [-h] [--project-id PROJECT_ID] [--version-id VERSION_ID]
                           [--latest-build] [--space-id SPACE_ID] [--tech-version TECH_VERSION]
                           [--no-dev-mode] [--wait] [--verify] [--no-verify] [--apply]
                           NAME

Arguments

Option	Description
`NAME`	the application name

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	source project; with `--version-id` its build list is checked for the source assembly, which the platform may have deleted (default: ELEMENT_PROJECT_ID)
`--version-id VERSION_ID`	id of the source assembly; if the project does not exist yet, create it with ‘builds upload <file>.xasm `--space-id` <id>’ without `--project-id`
`--latest-build`	source: the project’s latest assembly
`--space-id SPACE_ID`	space
`--tech-version TECH_VERSION`	technology version
`--no-dev-mode`	do not create a development environment
`--wait`	wait until the application is ready (and verify the assembly it runs)
`--verify`	verify that the application really runs the requested assembly (implies `--wait`); exit code 1 when it does not
`--no-verify`	do not verify the applied assembly – only wait until ready
`--apply`	when the application already exists, apply the given assembly to it (otherwise the answer only says that it was not applied)

`elemctl apps apply`

usage: elemctl apps apply [-h] [--app-id APP_ID] [APP_ID] VERSION_ID

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)
`VERSION_ID`	id of the uploaded assembly (the project version id)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps delete`

usage: elemctl apps delete [-h] [--app-id APP_ID] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps start`

usage: elemctl apps start [-h] [--app-id APP_ID] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps stop`

usage: elemctl apps stop [-h] [--app-id APP_ID] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps debug`

usage: elemctl apps debug [-h] [--app-id APP_ID] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps users`

usage: elemctl apps users [-h] [--app-id APP_ID] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only

`elemctl apps token-access`

usage: elemctl apps token-access [-h] [--app-id APP_ID] [--user USER] [--enable] [--disable]
                                 [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only
`--user USER`	the login, the presentation or the id of the user (default: the account elemctl signs in with); the key may be repeated: each user then gets an entry of its own in the answer, and a failure of one does not stop the rest
`--enable`	allow the access by a token and read the flag back
`--disable`	forbid the access by a token and read the flag back

`elemctl apps export`

usage: elemctl apps export [-h] [--app-id APP_ID] [--output OUTPUT] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only
`--output OUTPUT`	the file or the directory for the build; by default the current directory and the name after the manifest of the archive, “<Name> <Version>.xasm”

`elemctl apps export-extension`

usage: elemctl apps export-extension [-h] [--app-id APP_ID] [--output OUTPUT] [APP_ID] EXTENSION

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)
`EXTENSION`	the extension: the extension id, the id of its project, the name or the presentation of the project

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only
`--output OUTPUT`	the file or the directory for the build; by default the current directory and the name after the manifest of the archive, “<Name> <Version>.xasm”

`elemctl spaces`

usage: elemctl spaces [-h] action ...

Arguments

Option	Description
`list`	list spaces

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl spaces list`

usage: elemctl spaces list [-h]

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl projects`

usage: elemctl projects [-h] action ...

Arguments

Option	Description
`list`	list projects
`get`	project details
`delete`	delete a project

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl projects list`

usage: elemctl projects list [-h] [--name NAME] [--include-deleted]

Options

Option	Description
`-h, --help`	show this help message and exit
`--name NAME`	case-insensitive name substring filter (applied client-side)
`--include-deleted`	list deleted projects too (hidden by default)

`elemctl projects get`

usage: elemctl projects get [-h] [PROJECT_ID]

Arguments

Option	Description
`PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl projects delete`

usage: elemctl projects delete [-h] PROJECT_ID

Arguments

Option	Description
`PROJECT_ID`	the project id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl builds`

usage: elemctl builds [-h] action ...

Arguments

Option	Description
`list`	list project assemblies (newest first)
`get`	assembly details by version or id
`upload`	upload an assembly file (.xasm/.xlib)
`delete`	delete an assembly by version or id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl builds list`

usage: elemctl builds list [-h] [--project-id PROJECT_ID] [--limit LIMIT] [--brief]

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)
`--limit LIMIT`	how many assemblies to show (default 10; 0 – all)
`--brief`	brief cards: id, versions, date, branch, commit; what the card lacks comes from the local registry of uploads, and the source is named

`elemctl builds get`

usage: elemctl builds get [-h] [--project-id PROJECT_ID] VERSION

Arguments

Option	Description
`VERSION`	the assembly version or its id

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)

`elemctl builds upload`

usage: elemctl builds upload [-h] [--project-id PROJECT_ID] [--new-project] [--force-rename]
                             [--space-id SPACE_ID]
                             FILE

Arguments

Option	Description
`FILE`	the .xasm/.xlib assembly file

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	project; without it the platform creates a new project, which is the only way to create a project through the Console API
`--new-project`	upload the build without a project id, ignoring ELEMENT_PROJECT_ID from the environment and the .env file: the server puts it into the project of the Ид of its Проект.yaml or creates a new one
`--force-rename`	allow uploading an assembly whose name differs: the console renames the target project and its group after the assembly
`--space-id SPACE_ID`	the space to create the project in when `--project-id` is omitted (default: ELEMENT_SPACE_ID)

`elemctl builds delete`

usage: elemctl builds delete [-h] [--project-id PROJECT_ID] VERSION

Arguments

Option	Description
`VERSION`	the assembly version or its id

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)

`elemctl build`

usage: elemctl build [-h] [--project-dir PROJECT_DIR] [--output OUTPUT]
                     [--build-version BUILD_VERSION] [--last-build LAST_BUILD] [--commit COMMIT]
                     [--branch BRANCH] [--kind {application,library,extension}] [--require-clean]

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-dir PROJECT_DIR`	project directory (by default searched downward from the current one)
`--output OUTPUT`	directory for the archive (default: current)
`--build-version BUILD_VERSION`	explicit assembly version, e.g. 1.0-42
`--last-build LAST_BUILD`	the project’s last assembly version – for auto-increment
`--commit COMMIT`	commit hash for the manifest (default: from git)
`--branch BRANCH`	branch name for the manifest (default: from git)
`--kind {application,library,extension}`	project kind (default: from Проект.yaml/Project.yaml)
`--require-clean`	abort the build if the project directory has uncommitted changes

`elemctl inspect`

usage: elemctl inspect [-h] FILE

Arguments

Option	Description
`FILE`	assembly archive file

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl deploy`

usage: elemctl deploy [-h] [--expected-app-name EXPECTED_APP_NAME]
                      [--expected-app-uri EXPECTED_APP_URI] [--app-id APP_ID]
                      [--project-id PROJECT_ID] [--project-dir PROJECT_DIR] [--output OUTPUT]
                      [--build-version BUILD_VERSION] [--branch BRANCH] [--commit COMMIT]
                      [--dry-run] [--require-clean] [--allow-data-loss]
                      [--server-start-timeout SERVER_START_TIMEOUT]

Options

Option	Description
`-h, --help`	show this help message and exit
`--expected-app-name EXPECTED_APP_NAME`	expected exact application name; a mismatch stops the deploy before the build
`--expected-app-uri EXPECTED_APP_URI`	expected exact application URI; a mismatch stops the deploy before the build
`--app-id APP_ID`	the application id (default: ELEMENT_APP_ID)
`--project-id PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)
`--project-dir PROJECT_DIR`	the project directory (by default searched downward from the current one)
`--output OUTPUT`	directory for the archive (default: a temporary one)
`--build-version BUILD_VERSION`	explicit assembly version
`--branch BRANCH`	branch name for the metadata (default: from git)
`--commit COMMIT`	commit hash for the metadata (default: from git)
`--dry-run`	build only, no upload
`--require-clean`	abort the deploy if the project directory has uncommitted changes
`--allow-data-loss`	allow an apply that recreates or deletes data (a narrowed length, a changed attribute type, a tabular part included, a catalog, a document or a register removed whole, described anew under a new Id included); without the flag such a deploy is refused before the build. A removed attribute or tabular part needs no flag: the deploy names it and goes on
`--server-start-timeout SERVER_START_TIMEOUT`	how many seconds to wait for the 1C:Element server while it is starting and its console answers 404 “Application “console” not found“ (default 900; 0 – do not wait)

`elemctl user-lists`

usage: elemctl user-lists [-h] action ...

Arguments

Option	Description
`list`	list the user lists
`get`	the list card: registration, password policy, account services
`self-registration`	self-registration of users: show or switch
`password-login`	signing in with a login and a password (the Local account service): show or switch
`calculation-rules`	the rules that parse the account service’s answer: show the target or write them

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl user-lists list`

usage: elemctl user-lists list [-h] [--name NAME]

Options

Option	Description
`-h, --help`	show this help message and exit
`--name NAME`	filter by a presentation substring

`elemctl user-lists get`

usage: elemctl user-lists get [-h] [--app APP] [LIST]

Arguments

Option	Description
`LIST`	the user list id or its exact presentation

Options

Option	Description
`-h, --help`	show this help message and exit
`--app APP`	take the application’s own list (its id or exact name)

`elemctl user-lists self-registration`

usage: elemctl user-lists self-registration [-h] [--app APP] [--enable] [--disable] [LIST]

Arguments

Option	Description
`LIST`	the user list id or its exact presentation

Options

Option	Description
`-h, --help`	show this help message and exit
`--app APP`	take the application’s own list (its id or exact name)
`--enable`	turn on
`--disable`	turn off

usage: elemctl user-lists password-login [-h] [--app APP] [--enable] [--disable] [LIST]

Arguments

Option	Description
`LIST`	the user list id or its exact presentation

Options

Option	Description
`-h, --help`	show this help message and exit
`--app APP`	take the application’s own list (its id or exact name)
`--enable`	turn on
`--disable`	turn off

`elemctl user-lists calculation-rules`

usage: elemctl user-lists calculation-rules [-h] [--app APP] [--rules-file RULES_FILE]
                                            [--response-kind RESPONSE_KIND]
                                            [--presentation-rule PRESENTATION_RULE]
                                            [--phone-rule PHONE_RULE] [--email-rule EMAIL_RULE]
                                            [--service SERVICE] [--service-type SERVICE_TYPE]
                                            [LIST]

Arguments

Option	Description
`LIST`	the user list id or its exact presentation

Options

Option	Description
`-h, --help`	show this help message and exit
`--app APP`	take the application’s own list (its id or exact name)
`--rules-file RULES_FILE`	a JSON file with the whole set of rules
`--response-kind RESPONSE_KIND`	the kind of answer being parsed
`--presentation-rule PRESENTATION_RULE`	the rule that builds the user’s presentation
`--phone-rule PHONE_RULE`	the phone rule
`--email-rule EMAIL_RULE`	the email rule
`--service SERVICE`	the account service by id (default: the first service of type Oidc)
`--service-type SERVICE_TYPE`	the type of the account service when no id is given

`elemctl probe`

usage: elemctl probe [-h] [--project-dir PROJECT_DIR] [--output OUTPUT]
                     [--build-version BUILD_VERSION] [--name NAME] [--space-id SPACE_ID] [--keep]
                     [--require-clean] [--cleanup APP_ID]

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-dir PROJECT_DIR`	the project directory – …/{Vendor}/{Name} with Project.yaml inside (by default searched downward from the current one)
`--output OUTPUT`	directory for the archive (default: a temporary one)
`--build-version BUILD_VERSION`	explicit build version (default {base}`-probe-`{token} – it has to be a new one)
`--name NAME`	name of the throwaway application (default elemctl-probe-{token})
`--space-id SPACE_ID`	the space for the project and the application (ELEMENT_SPACE_ID)
`--keep`	skip the cleanup: leave the application and the build for a hands-on look; the report names the command that removes them
`--require-clean`	abort the check if the project directory has uncommitted changes
`--cleanup APP_ID`	remove a probe left behind, starting from its application (id or name): the application, the probe build in its project and the project when nothing else is left in it; a probe with a name and a version of its own is known by the local registry of uploads; an application that is not a probe’s is refused. The key may be repeated: the probes are removed in turn, each with a report of its own, and a refusal of one does not stop the rest

`elemctl verify-deploy`

usage: elemctl verify-deploy [-h] [--app-id APP_ID] [--version-id VERSION_ID]
                             [--expected-version EXPECTED_VERSION] [--since-minutes SINCE_MINUTES]
                             [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (UUID) or its exact name (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the same application as an option: deploy and apps ensure take this form only
`--version-id VERSION_ID`	id of the uploaded build expected to be applied – the reliable comparison (the server assigns the version string of a build uploaded into a project); a build of an extension is recognized and checked against the extensions of the application
`--expected-version EXPECTED_VERSION`	the version string instead of the build id – the fallback comparison
`--since-minutes SINCE_MINUTES`	how many last minutes of task failures count as ours (default 30)

`elemctl branches`

usage: elemctl branches [-h] action ...

Arguments

Option	Description
`list`	list branches
`get`	branch details
`create`	create a branch
`update`	update a branch (rebind to an application)
`delete`	delete a branch
`merge`	accept the branch’s changes

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl branches list`

usage: elemctl branches list [-h] [--project-id PROJECT_ID] [--name NAME]

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)
`--name NAME`	filter by branch name

`elemctl branches get`

usage: elemctl branches get [-h] ID

Arguments

Option	Description
`ID`	the branch id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl branches create`

usage: elemctl branches create [-h] [--project-id PROJECT_ID] [--app-id APP_ID] NAME

Arguments

Option	Description
`NAME`	the branch name

Options

Option	Description
`-h, --help`	show this help message and exit
`--project-id PROJECT_ID`	the project id (default: ELEMENT_PROJECT_ID)
`--app-id APP_ID`	bind to an application right away

`elemctl branches update`

usage: elemctl branches update [-h] [--app-id APP_ID] ID

Arguments

Option	Description
`ID`	the branch id

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	the application id (default: ELEMENT_APP_ID)

`elemctl branches delete`

usage: elemctl branches delete [-h] ID

Arguments

Option	Description
`ID`	the branch id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl branches merge`

usage: elemctl branches merge [-h] ID

Arguments

Option	Description
`ID`	the branch id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl dumps`

usage: elemctl dumps [-h] action ...

Arguments

Option	Description
`create`	create a dump
`get`	dump status

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl dumps create`

usage: elemctl dumps create [-h] [--description DESCRIPTION] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit
`--description DESCRIPTION`	dump description

`elemctl dumps get`

usage: elemctl dumps get [-h] APP_ID DUMP_ID

Arguments

Option	Description
`APP_ID`	the application id
`DUMP_ID`	the dump id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl tasks`

Application tasks. The forms: elemctl tasks list [--app-id ID] – the listing of tasks; elemctl tasks get-group TASK_ID – the status of a task group. The --app-id flag belongs to the list action and goes after it.

usage: elemctl tasks [-h] action ...

Arguments

Option	Description
`list`	list application tasks
`get-group`	group task status

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl tasks list`

usage: elemctl tasks list [-h] [--app-id APP_ID]

Options

Option	Description
`-h, --help`	show this help message and exit
`--app-id APP_ID`	filter by application (client-side)

`elemctl tasks get-group`

usage: elemctl tasks get-group [-h] TASK_ID

Arguments

Option	Description
`TASK_ID`	the group task id

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl tech`

usage: elemctl tech [-h] action ...

Arguments

Option	Description
`get`	the application’s technology version
`set`	update the technology version (group task)

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl tech get`

usage: elemctl tech get [-h] [APP_ID]

Arguments

Option	Description
`APP_ID`	the application id (default: ELEMENT_APP_ID)

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl tech set`

usage: elemctl tech set [-h] APP_ID VERSION

Arguments

Option	Description
`APP_ID`	the application id
`VERSION`	the technology version to move the application to

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl debug-adapter`

usage: elemctl debug-adapter [-h]

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl plugins`

usage: elemctl plugins [-h]

Options

Option	Description
`-h, --help`	show this help message and exit

`elemctl self-update`

usage: elemctl self-update [-h] [--version VERSION] [--stop-holders [{servers,all}]]

Options

Option	Description
`-h, --help`	show this help message and exit
`--version VERSION`	target version (default: the latest from PyPI)
`--stop-holders [{servers,all}]`	stop the servers holding the installation (elemctl MCP sessions) and update. Running commands of other sessions are named by pid and left alone; with the value all they are stopped too, and such a command ends without a result. Without the flag the holders are only named

`elemctl mcp`

usage: elemctl mcp [-h]

Options

Option	Description
`-h, --help`	show this help message and exit