Installation
curl -fsSL https://install.benediction.site/cli.sh | sh
# or, via a package manager:
# brew install gitflare (macOS)
# apt install gitflare-cli (Debian / Ubuntu)
# scoop install gitflare (Windows)
Global flags
| Flag | Description |
|---|
--org <slug> | Operate as an organization |
--output json | Machine-readable output |
--env <name> | Environment selector for Workers |
--debug | Verbose logging including request IDs |
--yes | Skip confirmation prompts |
Command groups
zones
gitflare zones add example.com # onboard a domain
gitflare zones list # show all zones + status
gitflare zones dns add example.com A @ 203.0.113.10 --ttl 300
gitflare zones dns rm example.com aa12… # remove by record id
workers
gitflare workers init ./my-worker # scaffold a project
gitflare workers dev ./my-worker # local dev server on :8787
gitflare workers deploy ./my-worker -e prod
gitflare workers tail my-worker # stream live logs
gitflare workers kv put my-worker SESSION=abc123 --namespace sessions
origins & rules
gitflare origins add --zone example.com --pattern "/api/*" \
--target https://origin.example.com --tls full
gitflare rules list example.com
gitflare rules waf add example.com \
--expression 'http.request.uri.path starts_with "/wp-admin" and not ip.src in { 203.0.113.0/24 }' \
--action block
cache & analytics
gitflare cache purge example.com --url https://example.com/assets/app.js
gitflare cache purge example.com --everything
gitflare analytics example.com --since 7d --granularity daily --output json
Environment variables
| Variable | Purpose |
|---|
BENEDICTION_TOKEN | API token (overrides stored credentials) |
BENEDICTION_ORG | Default organization slug |
BENEDICTION_API | Custom API base URL (self-hosted edge) |
BENEDICTION_NO_TELEMETRY | Set to 1 to disable usage telemetry |
Scripting example
Deploy a Worker and health-check it in a pipeline:
#!/usr/bin/env bash
set -euo pipefail
gitflare workers deploy ./src -e prod --yes
url="https://my-worker.benediction.site/health"
for attempt in $(seq 1 5); do
if curl -fsS "$url" | grep -q '"ok":true'; then
echo "✓ healthy after ${attempt} attempt(s)"
exit 0
fi
sleep 1
done
echo "✗ health check failed" >&2
exit 1