gekka-cli

Command-line interface for inspecting and managing a live gekka cluster via the HTTP Management API.

Installation

go install github.com/sopranoworks/gekka-cli@latest

Global Flags and Config File

gekka-cli [--config FILE] [--profile NAME] [--json] <subcommand>

Flag	Default	Description
--config FILE	~/.gekka/config.yaml	Path to the config file
--profile NAME	(default_profile)	Named profile to select from the config file
--json	false	Output raw JSON instead of a formatted table

Management URL resolution order (first match wins):

1. --url flag on the subcommand
2. --profile flag -> that profile's management_url in the config file
3. default_profile -> that profile's management_url in the config file
4. Top-level management_url in the config file
5. Built-in default: http://127.0.0.1:8558

Config file (~/.gekka/config.yaml):

management_url: http://127.0.0.1:8558
default_profile: local

profiles:
  local:
    management_url: http://127.0.0.1:8558
  staging:
    management_url: http://staging-node:8558
  prod:
    management_url: http://prod-seed-1:8558

Cluster Management

members -- List cluster members

Calls GET /cluster/members and prints a human-readable table of every known node with its address, status, data-center, roles, reachability, and RTT.

gekka-cli members
gekka-cli members --url http://prod-seed-1:8558
gekka-cli members --profile prod --json

Status colors:

• Green -- Up / Joining
• Red -- unreachable nodes
• Amber / Red RTT -- latency warnings (>=50 ms, >=200 ms, >=500 ms)

Shard Management

shards list <typeName> -- View shard distribution

gekka-cli shards list Cart
gekka-cli shards list Cart --json

shards rebalance <typeName> <shardID> <targetRegion> -- Move a shard

gekka-cli shards rebalance Cart shard-3 /user/Cart-region#2

Note: Manual rebalancing is intended for operational emergencies.

Interactive Dashboard

gekka-cli dashboard
gekka-cli dashboard --url http://staging-node:8558

Features:

• Automatic column alignment
• Roles marquee for long role strings
• Local node filter
• Exit confirmation overlay (q/ESC -> y/n)

Discovery Diagnostics

gekka-cli discovery-check

Verifies Kubernetes API or DNS service discovery settings before connecting to a real cluster.

License

This project is licensed under the MIT License — see LICENSE for details.

Derived from gekka by Sopranoworks, Osamu Takahashi.