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>] [-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 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 13.1.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 | Provenance | Actions |
|---|---|---|---|---|
| pragmatiks_cli-13.1.0.tar.gz | 65.4 kB | With provenance | Details for pragmatiks_cli-13.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pragmatiks_cli-13.1.0-py3-none-any.whl | Python 3 | none | any | Details for pragmatiks_cli-13.1.0-py3-none-any.whl |
Total release size: 140.3 kB
Release files / pragmatiks_cli-13.1.0.tar.gz
| Download URL | pragmatiks_cli-13.1.0.tar.gz |
|---|---|
| Size | 65.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e79eb20238623107dec155ab9bc11eb30b5556d1252181642e0c318aa86381d4
|
|
BLAKE2b-256 checksum How to use checksums |
0be0464535191f328e6bdbb15e6d740e02eacbff48d86bb5ce8a74d48d01ba81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 23, 2026.
Transparency logRelease files / pragmatiks_cli-13.1.0-py3-none-any.whl
| Download URL | pragmatiks_cli-13.1.0-py3-none-any.whl |
|---|---|
| Size | 75.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0b358fc15e8a4403060b353874c7e3809209f55d28c372fdcfa85ee640c9c824
|
|
BLAKE2b-256 checksum How to use checksums |
68a3cbeddbab3c24273e968ccb7ffbd7896ca1c47e5b93d55825a14a2bf0003a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 23, 2026.
Transparency logSecurity for pragmatiks-cli 13.1.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for pragmatiks_cli-13.1.0.tar.gz
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 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
