amqpcat
Version, currently 1.1.014 versions
- 1.1.1latestOct 1, 2026
- 1.1.0Feb 6, 2026
- 1.0.2not indexedFeb 11, 2026
- 1.0.1not indexedFeb 11, 2026
- 1.0.0not indexedFeb 11, 2026
- 0.2.5not indexedFeb 11, 2026
- 0.2.4not indexedFeb 11, 2026
- 0.2.3not indexedFeb 11, 2026
- 0.2.2not indexedFeb 11, 2026
- 0.2.1not indexedFeb 11, 2026
- 0.2.0not indexedFeb 11, 2026
- 0.1.2not indexedFeb 11, 2026
- 0.1.1not indexedFeb 11, 2026
- 0.1.0not indexedFeb 11, 2026
github.com/cloudamqp/amqpcat
CLI tool for publishing to and consuming from AMQP servers
Installation
# Add this to your shard.yml
dependencies:
amqpcat:
github: cloudamqp/amqpcat
version: ~> 1.1.0Then run:
shards installshard.yml
- Crystal
1.0.0- License
- MIT
- Author
- Carl Hörberg
- Target
amqpcatfrom src/cli.cr
Dependencies
Runtime Dependencies
- amqp-client*github: cloudamqp/amqp-client.cr
README
This README is the one indexed from the repository at its latest ref, not from the tag for this version.
amqpcat
netcat for AMQP. CLI tool to publish to and consume from AMQP servers.
Installation
Using snap:
snap install amqpcat
Using Homebrew in OS X:
brew install cloudamqp/cloudamqp/amqpcat
Using Docker/Podman:
docker run -it cloudamqp/amqpcat
From source:
brew install crystal # os x
snap install crystal # linux/ubuntu
git clone https://github.com/cloudamqp/amqpcat.git
cd amqpcat
shards build --release --production
There are more Crystal installation alternatives.
Usage
Usage: amqpcat [arguments]
-P, --producer Producer mode, reading from STDIN, each line is a new message
-C, --consumer Consume mode, message bodies are written to STDOUT
-u URI, --uri=URI URI to AMQP servera
-d DIR, --dir=DIR Directory to dump messages info when consuming
-e EXCHANGE, --exchange=EXCHANGE Exchange
-r ROUTINGKEY, --routing-key=KEY Routing key when publishing
-q QUEUE, --queue=QUEUE Queue to consume from
-f FORMAT, --format=FORMAT Format string (default "%s\n")
%e: Exchange name
%r: Routing key
%s: Body, as string
\n: Newline
\t: Tab
-v, --version Display version
-h, --help Show this help message
Examples
Send messages to a queue named test:
echo Hello World | amqpcat --producer --uri=$CLOUDAMQP_URL --queue test
Consume from the queue named test:
amqpcat --consumer --uri=$CLOUDAMQP_URL --queue test
Consume from the queue named files, dumping each message into a given
directory, instead of STDOUT, deriving the filename from the message
properties, or timestamp if no properties are set:
amqpcat --consumer --uri=$CLOUDAMQP_URL --queue files --dir /tmp/miaow/
With a temporary queue, consume messages sent to the exchange amq.topic with the routing key 'hello.world':
amqpcat --consumer --uri=$CLOUDAMQP_URL --exchange amq.topic --routing-key hello.world
Consume from the queue named test, format the output as CSV and pipe to file:
amqpcat --consumer --uri=$CLOUDAMQP_URL --queue test --format "%e,%r,"%s"\n | tee messages.csv
Publish messages from syslog to the exchange 'syslog' topic with the hostname as routing key
tail -f /var/log/syslog | amqpcat --producer --uri=$CLOUDAMQP_URL --exchange syslog --routing-key $HOSTNAME
Consume, parse and extract data from json messages:
amqpcat --consumer --queue json | jq .property
Development
amqpcat is built with Crystal
Contributing
- Fork it (https://github.com/cloudamqp/amqpcat/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Contributors
- Carl Hörberg - creator and maintainer
Documentation
Built from the current release. The first visit to a release nobody has asked for starts its build.
Links
This release
- Version
1.1.0- Tagged
- Feb 6, 2026
- Commit
5f24b6ee9ad4- Crystal
1.0.0- Indexed
- yes
Dependents
No indexed shard depends on this one yet.
Repository
github.com/cloudamqp/amqpcat
Metadata
- Created
- Aug 12, 2026
- Updated
- Nov 19, 2026
- Synced
- Nov 19, 2026
- Versions
- 14