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 7.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 7.0.1
File	Size	Uploaded
pragmatiks_cli-7.0.1.tar.gz	46.6 kB	Jul 23, 2026	Details

Built distribution (wheel)

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

Total release size: 101.6 kB

Release files / pragmatiks_cli-7.0.1.tar.gz

Download URL	pragmatiks_cli-7.0.1.tar.gz
Size	46.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`4650b9f6fcab7e83f0750916c129bddd61a0529d66b7af792dc664f5befa7638`
BLAKE2b-256 checksum How to use checksums	`c2e5a25e88710474de7e0fe477730ba4f6d0d5be05aef0f8be96f2c8627d14af`
Upload date	Jul 23, 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/26e89bfc381bba8431a8cfe74e7d16602da42eb3

Workflow

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

Artifact

Subject: pragmatiks_cli-7.0.1.tar.gz
SHA-256 checksum: 4650b9f6fcab7e83f0750916c129bddd61a0529d66b7af792dc664f5befa7638 Verifying attestations

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

Download URL	pragmatiks_cli-7.0.1-py3-none-any.whl
Size	54.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c1308d0960cfc8a793488871cab48780532629b68891aeb0bc438fdab9bad7ff`
BLAKE2b-256 checksum How to use checksums	`83b03ebcd6ba6977d0b7948c47333fac0f9cd2d25f16ed798def824cb03a803d`
Upload date	Jul 23, 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/26e89bfc381bba8431a8cfe74e7d16602da42eb3

Workflow

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

Artifact

Subject: pragmatiks_cli-7.0.1-py3-none-any.whl
SHA-256 checksum: c1308d0960cfc8a793488871cab48780532629b68891aeb0bc438fdab9bad7ff Verifying attestations