Documentation | SDK | Providers
Command-line interface for managing Pragmatiks resources.
pip install pragmatiks-cliEnable shell completion:
pragma --install-completion# Authenticate
pragma auth login
# Apply a resource from YAML
pragma resources apply bucket.yaml
# Check status
pragma resources get pragmatiks/gcp/secret/my-secretExit codes and output streams are listed in pragma --help: errors and warnings go to stderr, command output (including -o json) to stdout.
| Command | Description |
|---|---|
pragma resources list |
List resources with optional filters |
pragma resources schemas |
List available resource schemas |
pragma resources get <org/provider/resource[/name]> |
Get resource(s) by type or full ID |
pragma resources describe <org/provider/resource/name> |
Show detailed resource info |
pragma resources apply <file> |
Apply resources from YAML |
pragma resources delete <org/provider/resource/name> | -f <file> |
Delete a resource |
pragma resources deactivate <org/provider/resource/name> | -f <file> |
Deactivate a resource |
pragma resources tags list/add/remove |
Manage resource tags |
| Command | Description |
|---|---|
pragma providers list [--installed] [-o json|yaml] |
List providers in the store; --installed lists your installed providers with their state, served version, latest operation and its target version, and failure message |
pragma providers init <name> |
Initialize a new provider project |
pragma providers update [project-directory] |
Update project from template |
pragma providers publish [project-directory | --wheel <path>] [--changelog <file>] [-o json|yaml] |
Build the wheel via uv build into <project-directory>/dist (or take a prebuilt one), rename a copy to your organization's distribution name (<organization>-<provider>), declare the version and upload that copy if Pragmatiks does not have it yet, and wait until your organization's provider host admits it (published) or refuses it (failed); -o json|yaml prints the operation id and the version's last-read record on stdout once the wait ends |
pragma providers versions <name> [-o json|yaml] |
List a provider's versions with their status (for example waiting for the provider host, admitting, publishing to the registry) |
pragma providers history <name> [-o json|yaml] |
Show an installed provider's history, newest first: time, transition, operation, version, message and cause; kept 30 days, also after an uninstall |
pragma providers delete <name> [--yes] |
Delete a provider from the catalog (admins of the owning organization only); a provider that is still installed is refused |
| Command | Description |
|---|---|
pragma config current-context |
Show current context |
pragma config get-contexts |
List available contexts |
pragma config use-context <name> |
Switch context |
pragma config set-context <name> --api-url <url> |
Create/update context |
pragma config delete-context <name> |
Delete context |
| Command | Description |
|---|---|
pragma auth login |
Authenticate (opens browser) |
pragma auth whoami |
Show current user |
pragma auth logout |
Clear credentials |
| Variable | Description |
|---|---|
PRAGMA_CONTEXT |
Override current context |
PRAGMA_AUTH_TOKEN |
Authentication token |
PRAGMA_AUTH_TOKEN_<CONTEXT> |
Context-specific token |
MIT
