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 10.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 10.0.1
File	Size	Uploaded
pragmatiks_cli-10.0.1.tar.gz	49.1 kB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pragmatiks-cli 10.0.1
File	Interpreter	ABI	Platform	Reset
pragmatiks_cli-10.0.1-py3-none-any.whl 57.7 kB Oct 1, 2026	Python 3	none	any	Details

Total release size: 106.9 kB

Release files / pragmatiks_cli-10.0.1.tar.gz

Download URL	pragmatiks_cli-10.0.1.tar.gz
Size	49.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`e7e13952101d6a96896d4327be726830d10062bfbdae86defacdc5aea73b9821`
BLAKE2b-256 checksum How to use checksums	`3abc69719f9150211dd96dec9432a9d779c7168ec2290f10dadc06a1a9f07ba8`
Upload date	Oct 1, 2026
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.

Identity

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

Workflow

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

Artifact

Subject: pragmatiks_cli-10.0.1.tar.gz
SHA-256 checksum: e7e13952101d6a96896d4327be726830d10062bfbdae86defacdc5aea73b9821 Verifying attestations

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

Download URL	pragmatiks_cli-10.0.1-py3-none-any.whl
Size	57.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b0f6e8acfed053229a1e2dead71b5b9310ead96bbb185b38ea5b17ac199b3373`
BLAKE2b-256 checksum How to use checksums	`0c1be3d50313db9961211a06c578434cfa001c0bea196effe0fb10550a09b3fd`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.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/bf29df8fa18814c4770fcc047a821751f6e4432a

Workflow

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

Artifact

Subject: pragmatiks_cli-10.0.1-py3-none-any.whl
SHA-256 checksum: b0f6e8acfed053229a1e2dead71b5b9310ead96bbb185b38ea5b17ac199b3373 Verifying attestations