rivven

Command-line interface for the Rivven event streaming platform.

Overview

rivven provides a unified CLI for managing topics, producing/consuming messages, and administering clusters. Designed for both interactive use and scripting.

Installation

cargo install rivven

Quick Start

# Create a topic
rivven topic create my-topic --partitions 3

# Produce messages
rivven produce my-topic "Hello, Rivven!"

# Consume messages
rivven consume my-topic --from-beginning

Commands

Topic Management

# List topics
rivven topic list

# Create topic with partitions
rivven topic create my-topic --partitions 3

# Describe topic details
rivven topic describe my-topic

# Delete topic
rivven topic delete my-topic

Produce Messages

# Produce from stdin
echo '{"event": "test"}' | rivven produce my-topic

# Produce with key
rivven produce my-topic --key user-123 --value '{"action": "login"}'

# Produce from file
rivven produce my-topic --file events.jsonl

Consume Messages

# Consume from beginning
rivven consume my-topic --from-beginning

# Consume with consumer group
rivven consume my-topic --group my-group

# Consume specific partition/offset
rivven consume my-topic --partition 0 --offset 100

# Consume with limit
rivven consume my-topic --max-messages 10

Cluster Operations

# Cluster status
rivven cluster status

# List brokers
rivven cluster brokers

# Consumer groups
rivven group list
rivven group describe my-group

Configuration

Output Formats

rivven topic list --output json    # JSON output
rivven topic list --output table   # Table output (default)
rivven topic list --output compact # Compact output

Documentation

• Getting Started
• CLI Reference

License

Apache-2.0. See LICENSE.