https://github.com/pragmatiks/pragma-cli
Command-line interface for pragma-os. Declarative resource management with YAML manifests.
https://github.com/pragmatiks/pragma-cli
cli command-line developer-tools devex gitops infrastructure-as-code platform-engineering python resource-management yaml
Last synced: 12 days ago
JSON representation
Command-line interface for pragma-os. Declarative resource management with YAML manifests.
- Host: GitHub
- URL: https://github.com/pragmatiks/pragma-cli
- Owner: pragmatiks
- License: mit
- Created: 2026-01-12T23:23:03.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-01T17:38:16.000Z (27 days ago)
- Last Synced: 2026-03-01T19:51:12.670Z (27 days ago)
- Topics: cli, command-line, developer-tools, devex, gitops, infrastructure-as-code, platform-engineering, python, resource-management, yaml
- Language: Python
- Homepage: https://docs.pragmatiks.io/cli/overview
- Size: 232 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Pragma CLI
[](https://deepwiki.com/pragmatiks/pragma-cli)
[](https://pypi.org/project/pragmatiks-cli/)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
**[Documentation](https://docs.pragmatiks.io/cli/overview)** | **[SDK](https://github.com/pragmatiks/pragma-sdk)** | **[Providers](https://github.com/pragmatiks/pragma-providers)**
Command-line interface for managing pragma-os resources.
## Installation
```bash
pip install pragmatiks-cli
```
Enable shell completion:
```bash
pragma --install-completion
```
## Quick Start
```bash
# 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 [name]` | Get resource(s) by type |
| `pragma resources describe ` | Show detailed resource info |
| `pragma resources apply ` | Apply resources from YAML |
| `pragma resources delete ` | Delete a resource |
| `pragma resources tags list/add/remove` | Manage resource tags |
### Providers
| Command | Description |
|---------|-------------|
| `pragma providers list` | List deployed providers |
| `pragma providers init ` | Initialize a new provider project |
| `pragma providers update` | Update project from template |
| `pragma providers push [--deploy]` | Build and push (optionally deploy) |
| `pragma providers deploy [version]` | Deploy a specific version |
| `pragma providers status ` | Check deployment status |
| `pragma providers builds ` | List build history |
| `pragma providers delete [--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 ` | Switch context |
| `pragma config set-context --api-url ` | Create/update context |
| `pragma config delete-context ` | 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 ` | Show event details |
| `pragma ops dead-letter retry [--all]` | Retry failed event(s) |
| `pragma ops dead-letter delete [--all]` | Delete failed event(s) |
## Environment Variables
| Variable | Description |
|----------|-------------|
| `PRAGMA_CONTEXT` | Override current context |
| `PRAGMA_AUTH_TOKEN` | Authentication token |
| `PRAGMA_AUTH_TOKEN_` | Context-specific token |
## License
MIT