Pragmatiks

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 gcp/storage my-bucket

Commands

Resources

Command	Description
`pragma resources list`	List resources with optional filters
`pragma resources types`	List available resource types
`pragma resources get <type> [name]`	Get resource(s) by type
`pragma resources describe <type> <name>`	Show detailed resource info
`pragma resources apply <file>`	Apply resources from YAML
`pragma resources delete <type> <name>`	Delete 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`	Update project from template
`pragma providers publish [dir] [--wheel <path>] [--changelog <file>]`	Build wheel via `uv build` (or take a prebuilt one) and upload it to the Pragmatiks API, which hosts it and computes its digest
`pragma providers deploy <id> [version]`	Deploy a specific version
`pragma providers status <id>`	Check deployment status
`pragma providers delete <id> [--cascade]`	Delete a provider

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]`	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

Metadata

Release files for pragmatiks-cli 5.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pragmatiks-cli 5.0.1
File	Size	Uploaded
pragmatiks_cli-5.0.1.tar.gz	53.2 kB	Jul 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pragmatiks-cli 5.0.1
File	Interpreter	ABI	Platform	Reset
pragmatiks_cli-5.0.1-py3-none-any.whl 62.7 kB Jul 20, 2026	Python 3	none	any	Details

Total release size: 115.9 kB

Release files / pragmatiks_cli-5.0.1.tar.gz

Download URL	pragmatiks_cli-5.0.1.tar.gz
Size	53.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`bdd9f619edd13202c6dd58f2adea6099c638b2e88d4b727ed62da15ad150d8e3`
BLAKE2b-256 checksum How to use checksums	`d1f450d99d73788d6e7828af84f5bc0abe3a14e888aa6122d39c7a5961f63a49`
Upload date	Jul 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pragmatiks/pragma-cli
Publishing commit: github.com/pragmatiks/pragma-cli/tree/b42f0d35b4fc89ddad5c391750e7561a1154601f

Workflow

Publishing configuration: github.com/pragmatiks/pragma-cli/blob/b42f0d35b4fc89ddad5c391750e7561a1154601f/.github/workflows/publish.yaml
Publishing logs: github.com/pragmatiks/pragma-cli/actions/runs/29728155150/attempts/1

Artifact

Subject: pragmatiks_cli-5.0.1.tar.gz
SHA-256 checksum: bdd9f619edd13202c6dd58f2adea6099c638b2e88d4b727ed62da15ad150d8e3 Verifying attestations

Release files / pragmatiks_cli-5.0.1-py3-none-any.whl

Download URL	pragmatiks_cli-5.0.1-py3-none-any.whl
Size	62.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d69528c86713255450f9d2631fab6b8d2716b5a3b2fe33555552a1537c4330f1`
BLAKE2b-256 checksum How to use checksums	`ca7437edf8b441dbbd1a138c11ba4c7ffd4e357ac05a7ef53db23e511e05457d`
Upload date	Jul 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pragmatiks/pragma-cli
Publishing commit: github.com/pragmatiks/pragma-cli/tree/b42f0d35b4fc89ddad5c391750e7561a1154601f

Workflow

Publishing configuration: github.com/pragmatiks/pragma-cli/blob/b42f0d35b4fc89ddad5c391750e7561a1154601f/.github/workflows/publish.yaml
Publishing logs: github.com/pragmatiks/pragma-cli/actions/runs/29728155150/attempts/1

Artifact

Subject: pragmatiks_cli-5.0.1-py3-none-any.whl
SHA-256 checksum: d69528c86713255450f9d2631fab6b8d2716b5a3b2fe33555552a1537c4330f1 Verifying attestations