Pragma CLI
Documentation | SDK | Providers
Command-line interface for managing Pragmatiks resources.
Installation
pip install pragmatiks-cli
Enable shell completion:
pragma --install-completion
Quick Start
# Authenticate
pragma auth login
# Apply a resource from YAML
pragma resources apply bucket.yaml
# Check status
pragma resources get pragmatiks/gcp/secret/my-secret
Commands
Exit codes and output streams are listed in pragma --help: errors and warnings go to stderr, command output (including -o json) to stdout.
Resources
| 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 |
Providers
| Command | Description |
|---|---|
pragma providers list |
List deployed providers |
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>] |
Build the wheel via uv build into <project-directory>/dist (or take a prebuilt one), declare the version and upload the wheel if the platform does not have it yet, and wait until your organization's provider host admits it (published) or refuses it (failed) |
pragma providers versions <name> |
List a provider's versions with their status (for example waiting for the provider host, admitting, publishing to the registry) |
pragma providers deploy <name> [--version <v>] |
Restart an installed provider at its installed version; --version must name a published version and does not change the installed one (use upgrade or downgrade) |
pragma providers status <name> [-o json|yaml] |
Check deployment status |
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 |
Configuration
| 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 |
Authentication
| Command | Description |
|---|---|
pragma auth login |
Authenticate (opens browser) |
pragma auth whoami |
Show current user |
pragma auth logout |
Clear credentials |
Operations
| Command | Description |
|---|---|
pragma ops dead-letter list |
List failed events |
pragma ops dead-letter show <id> |
Show event details |
pragma ops dead-letter retry <id> | --all |
Retry failed event(s) |
pragma ops dead-letter delete <id> | --all | --provider <name> |
Delete failed event(s) |
Environment Variables
| Variable | Description |
|---|---|
PRAGMA_CONTEXT |
Override current context |
PRAGMA_AUTH_TOKEN |
Authentication token |
PRAGMA_AUTH_TOKEN_<CONTEXT> |
Context-specific token |
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for pragmatiks-cli 12.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pragmatiks_cli-12.0.0.tar.gz | 60.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pragmatiks_cli-12.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 129.5 kB
Release files / pragmatiks_cli-12.0.0.tar.gz
| Download URL | pragmatiks_cli-12.0.0.tar.gz |
|---|---|
| Size | 60.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
125d4e1f31ef421bb6c5d4b9ad7bf93a3e27bddc3893ba0f0a5eeb20b04f1828
|
|
BLAKE2b-256 checksum How to use checksums |
5f01d975b4a9e7857dc6fa21c7e977d40a4fe136e8dda9ef4705d6f27aebf295
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pragmatiks_cli-12.0.0-py3-none-any.whl
| Download URL | pragmatiks_cli-12.0.0-py3-none-any.whl |
|---|---|
| Size | 68.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0d3e4fd74aacb86793dbaaf7e14b544e024664a1a76d102bd778eede6a1a1b8c
|
|
BLAKE2b-256 checksum How to use checksums |
69636a680aa69bedba975cdcc5d21560a87d1262bb88c425f329d9f12c6c272d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency log
