https://github.com/birdayz/kaf
Modern CLI for Apache Kafka, written in Go.
https://github.com/birdayz/kaf
Last synced: 29 days ago
JSON representation
Modern CLI for Apache Kafka, written in Go.
- Host: GitHub
- URL: https://github.com/birdayz/kaf
- Owner: birdayz
- License: apache-2.0
- Created: 2018-09-11T22:57:19.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-12-31T00:36:42.000Z (about 2 months ago)
- Last Synced: 2026-01-12T05:01:48.461Z (about 1 month ago)
- Language: Go
- Homepage:
- Size: 15.4 MB
- Stars: 2,381
- Watchers: 18
- Forks: 158
- Open Issues: 79
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-platform-engineering - kaf - Modern CLI for Apache Kafka, written in Go (Kafka / Infrastructure from code)
- awesome-ccamel - birdayz/kaf - Modern CLI for Apache Kafka, written in Go. (Go)
- reading-material - kaf: Modern CLI for Apache Kafka
- awesome-repositories - birdayz/kaf - Modern CLI for Apache Kafka, written in Go. (Go)
README
# Kaf
Kafka CLI inspired by kubectl & docker
[](https://github.com/birdayz/kaf/actions)
[](https://goreportcard.com/report/github.com/birdayz/kaf)
[](https://godoc.org/github.com/birdayz/kaf)
## Install
Install via Go from source:
```
go install github.com/birdayz/kaf/cmd/kaf@latest
```
Install via install script:
```
curl https://raw.githubusercontent.com/birdayz/kaf/master/godownloader.sh | BINDIR=$HOME/bin bash
```
Install on Archlinux via [AUR](https://aur.archlinux.org/packages/kaf-bin/):
```
yay -S kaf-bin
```
Install via Homebrew:
```
brew tap birdayz/kaf
brew install kaf
```
## Usage
Show the tool version
`kaf --version`
Add a local Kafka with no auth
`kaf config add-cluster local -b localhost:9092`
Select cluster from dropdown list
`kaf config select-cluster`
Describe and List nodes
`kaf node ls`
List topics, partitions and replicas
`kaf topics`
Describe a given topic called _mqtt.messages.incoming_
`kaf topic describe mqtt.messages.incoming`
### Group Inspection
List consumer groups
`kaf groups`
Describe a given consumer group called _dispatcher_
`kaf group describe dispatcher`
Write message into given topic from stdin
`echo test | kaf produce mqtt.messages.incoming`
```
echo {"data":1} | kaf produce mqtt.messages.incoming --key 1 --header h1:hv1
> Sent record to partition 0 at offset 0.
kaf consume mqtt.messages.incoming --output json-each-row
> {"topic":"mqtt.messages.incoming","partition":0,"offset":0,"timestamp":"2025-07-04T12:53:46.841+02:00","headers":[{"key":"h1","value":"hv1"}],"key":"1","payload":"{data:1}"}
echo '{"topic":"mqtt.messages.incoming","partition":0,"offset":0,"timestamp":"2025-07-04T12:53:46.841+02:00","headers":[{"key":"h1","value":"hv1"}],"key":"1","payload":"{data:1}"}' | kaf produce mqtt.messages.incoming --input json-each-row
kaf consume mqtt.messages.incoming --output json-each-row
> {"topic":"mqtt.messages.incoming","partition":0,"offset":1,"timestamp":"2025-07-04T13:05:57.9+02:00","headers":[{"key":"h1","value":"hv1"}],"key":"1","payload":"{data:1}"}
```
Pipe from one topic to another
`kaf consume topic-a --output json-each-row -f | kaf produce topic-b --input json-each-row`
Important: kaf produce will overwrite key, partition and all the headers and of input messages if provided
Consume messages with filtering by header
`kaf consume mqtt.messages.incoming --header h1:hv1`
### Offset Reset
Set offset for consumer group _dispatcher_ consuming from topic _mqtt.messages.incoming_ to latest for all partitions
`kaf group commit dispatcher -t mqtt.messages.incoming --offset latest --all-partitions`
Set offset to oldest
`kaf group commit dispatcher -t mqtt.messages.incoming --offset oldest --all-partitions`
Set offset to 1001 for partition 0
`kaf group commit dispatcher -t mqtt.messages.incoming --offset 1001 --partition 0`
## Configuration
See the [examples](examples) folder
## Shell autocompletion
Source the completion script in your shell commands file:
Bash Linux:
```kaf completion bash > /etc/bash_completion.d/kaf```
Bash MacOS:
```kaf completion bash > /usr/local/etc/bash_completion.d/kaf```
Zsh
```kaf completion zsh > "${fpath[1]}/_kaf"```
Fish
```kaf completion fish > ~/.config/fish/completions/kaf.fish```
Powershell
```Invoke-Expression (@(kaf completion powershell) -replace " ''\)$"," ' ')" -join "`n")```
## Sponsors
### [Redpanda](https://github.com/redpanda-data/redpanda)
- The streaming data platform for developers
- Single binary w/no dependencies
- Fully Kafka API compatible
- 10x lower P99 latencies, 6x faster transactions
- Zero data loss by default
### [Zerodha](https://zerodha.tech)