Skip to content

About

Command-line interface for pragma-os. Declarative resource management with YAML manifests.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Pragmatiks

Pragma CLI

Ask DeepWiki PyPI version Python 3.13+ License: MIT

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 [--installed] [-o json|yaml] List providers in the store; --installed lists your installed providers with their state, served version, latest operation and its target version, and failure message
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 history <name> [-o json|yaml] Show an installed provider's history, newest first: time, transition, operation, version, message and cause; kept 30 days, also after an uninstall
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

Environment Variables

Variable Description
PRAGMA_CONTEXT Override current context
PRAGMA_AUTH_TOKEN Authentication token
PRAGMA_AUTH_TOKEN_<CONTEXT> Context-specific token

License

MIT

About

Command-line interface for pragma-os. Declarative resource management with YAML manifests.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages