Open Source Ecosystems

Nostr client CLI application for cross-platform

[!CAUTION] Work in progress. Development just started on May 17, 2024. Some features are not yet implemented.

Honeycomb is an application that uses the Nostr Protocol to post messages and view trends from the terminal. It is designed to offer both a Command Line Interface and a Text User Interface.

My main purposes for developing Honeycomb are the following:

To create a comfortable social network as an alternative to X (formerly Twitter) and BlueSky.
To serve as a testing ground for trying out new technologies.

I enjoy having a free environment and working in the terminal. Therefore, I intend to develop a user-friendly CLI.

How to install

go install

go install github.com/nao1215/honeycomb@latest

homebrew

brew install nao1215/tap/honeycomb

Supported platforms and requirements

Linux
macOS
Windows
go 1.21 or later

How to use

Log in with an existing account

Honeycomb checks for the presence of a private key (e.g. nsec**) available at ${XDG_CONFIG_HOME}/.config/honeycomb/private_key. If no private key is found, honeycomb will prompt you to enter your private key.

Honeycomb validates the private key and stores the correct private key locally. The feature to create a new account using Honeycomb is not yet implemented. However, we plan to offer this functionality in the future.

View timeline, follow users, and more

Once you have logged in, you can view your timeline, follow users, and more. Now, we have several tabs that are not yet implemented.

Press 'R' to retrieve the latest timeline. Continuously scrolling down on the timeline screen will automatically fetch older posts.

Reaction to messages

Honeycomb allows you to react to posts. The reactions will include Reply, Repost, Like, Unlike, and Zap (not yet implemented). The reaction modal can be displayed by pressing the Enter key to select the topmost post.

Post a message

You can post a message by pressing the p key. The message will be displayed in the timeline of the users who follow you.

Key bindings

Ctrl + C, q, <ESC>: Exit
TAB : Switch tabs
SHIFT + TAB : Switch tabs in reverse order
↑, ↓ : Move cursor
p : Show post form

Contributing

First off, thanks for taking the time to contribute! See CONTRIBUTING.md for more information. Contributions are not only related to development. For example, GitHub Star and GitHub Sponsor motivates me to develop!

Star History

Contact

If you would like to send comments such as "find a bug" or "request for additional features" to the developer, please use one of the following contacts.