requests CLI

Command line interface for the BlueFunda bluerequests platform — event-driven change and release management for SAP operations.

The binary is requests. Use it to subscribe to events, publish messages, manage users, and interact with the BFF gRPC API from the terminal.

Installation

One-line installer (macOS and Linux)

sh -c "$(curl -fsSL https://raw.githubusercontent.com/bluefunda/trm-cli/main/install.sh)"

Installs to /usr/local/bin if writable, otherwise ~/.local/bin. Override with REQUESTS_INSTALL_DIR.

Homebrew (macOS)

brew tap bluefunda/tap
brew install --cask requests

Debian / Ubuntu

curl -sL https://github.com/bluefunda/trm-cli/releases/latest/download/requests_<version>_linux_amd64.deb -o requests.deb
sudo dpkg -i requests.deb

RHEL / Fedora / Rocky

sudo dnf install https://github.com/bluefunda/trm-cli/releases/latest/download/requests_<version>_linux_amd64.rpm

From GitHub Releases

Download the binary for your platform from the releases page.

Platform	Archive
macOS (ARM64)	requests_<version>_darwin_arm64.zip
macOS (AMD64)	requests_<version>_darwin_amd64.zip
Linux (AMD64)	requests_<version>_linux_amd64.tar.gz
Linux (ARM64)	requests_<version>_linux_arm64.tar.gz

From Source

go install github.com/bluefunda/trm-cli/cmd/requests@latest

Quick Start

# Authenticate (opens browser for OAuth device flow)
requests login

# Check connection
requests health

# Subscribe to all events
requests events subscribe

# Subscribe to a specific pattern
requests events subscribe "orders.>"

# Publish an event
requests events publish "orders.created" '{"id":"123"}'

# Show current user
requests user info

Commands

Command	Description
requests login	Authenticate via OAuth2 device flow
requests health	Check gRPC connection to the backend
requests events subscribe [pattern]	Stream realm-scoped events (Ctrl-C to stop)
requests events publish <subject> <data>	Publish an event to a realm-scoped subject
requests rpc request <subject> <data>	Low-level request-reply
requests user info	Show current user details
requests version	Print CLI version

Run requests <command> --help for full options.

Authentication

requests CLI uses the OAuth2 device authorization flow:

1. requests login requests a device code
2. Your browser opens the verification URL
3. The CLI polls for authorization completion
4. Tokens are stored locally in ~/.trm/

Tokens are refreshed automatically — you only need to log in once.

Configuration

# ~/.trm/config.yaml
bff_url: grpc.bluefunda.com:443

License

See LICENSE.