Skip to content

CLI reference

plasmactl is the single CLI for all Plasma operations. It is built on Launchr and a set of plugins, each owning a command namespace (noun:verb).

Plugin Namespace Purpose
plasmactl Core CLI framework and platform actions
plasmactl-model model: Compose packages and prepare/bundle/release platform models
plasmactl-component component: Component versioning, dependencies, attach/detach
plasmactl-platform platform: Platform lifecycle — create, up, deploy, destroy
plasmactl-node node: Node provisioning across providers
plasmactl-zone zone: Topology structure — zones and node allocations
plasmactl-auth auth: Provider authentication — login, logout, status
plasmactl-processors Template processors (e.g. Ansible Vault)

Credential storage is handled by the keyring: namespace (from launchr) — keyring:login, keyring:set, keyring:list, and friends.

Install the CLI with:

curl -sSL https://get.plasma.sh | sh

The pages in this section mirror each plugin's repository README. For the exact, authoritative command set in your installed version, run plasmactl <namespace> --help (e.g. plasmactl model --help).