kokaq-repl is an interactive REPL (Read-Eval-Print Loop) for exploring and debugging kokaq message queues via gRPC. kokaq-repl provides a developer-friendly CLI for inspecting namespaces, managing queues, and working with messages — including DLQ, peek-lock, and consumer group support.

📦 Installation

go install github.com/kokaq/repl@latest

🧪 Usage

kokaq-repl --server localhost:9000 --namespace default

Inside the shell:

kokaq> list namespaces
kokaq> create namespace dev
kokaq> create queue orders --visibility 30s
kokaq> enqueue orders "hello world"
kokaq> dequeue orders
kokaq> ack 8423bcd0-221b-49d0
kokaq> dlq reprocess orders

⚙️ CLI Options

--server         Address of the gRPC server (default: localhost:9000)
--namespace      Default namespace to use
--tls            Enable TLS
--token          Bearer auth token
--log-level      Log verbosity: debug | info | warn | error

🧠 Examples

# Create a queue and send messages
kokaq> create queue logs
kokaq> enqueue logs "log entry 1"
kokaq> enqueue logs "log entry 2"

# Receive and ack messages
kokaq> dequeue logs
kokaq> ack <message-id>

# Explore DLQ
kokaq> dlq list logs
kokaq> dlq reprocess logs --limit 10

🧱 Contributing

Contributions welcome! Please see CONTRIBUTING.md for code style and testing requirements.

📜 License

MIT — open-source and production-ready.