Nostr CLI with interactive TUI and Gopher-style output (Gostr). Based on noscl by fiatjaf.

• Go 1.21 or later
• ~32 MB RAM (64 MB recommended)
• Terminal with ANSI support, 80x24 minimum for TUI
• Internet connection for Nostr relays (public relays at nostr.watch/relays)

Runs on Linux, macOS, Windows, and FreeBSD. Tested on x86_64 and ARM (e.g. Raspberry Pi).

git clone https://github.com/k4lb1/Gostr.git
cd Gostr
make

The binary is built as noscl in the project directory. To install system-wide:

sudo mv noscl /usr/local/bin/

go install github.com/k4lb1/Gostr@latest

The binary is placed in $HOME/go/bin/ or $GOPATH/bin as gostr. Ensure that directory is in your PATH.

On first run, config and data are stored in ~/.config/nostr/. Override with -datadir:

noscl -datadir ~/.nostr home

noscl

Usage:
  noscl tui
  noscl home [--gopher] [--verbose] [--json] [--onlyreplies] [--noreplies] [--kinds=<kinds>...] [--since=<since>] [--until=<until>] [--limit=<limit>]
  noscl inbox [--gopher] [--verbose] [--json] [--onlyreplies] [--noreplies] [--since=<since>] [--until=<until>] [--limit=<limit>]
  noscl setprivate <key>
  noscl sign <event-json>
  noscl verify <event-json>
  noscl public
  noscl publish [--reference=<id>...] [--profile=<id>...] [--file=<file>] [<content>]
  noscl message [--reference=<id>...] <pubkey> <content>
  noscl metadata --name=<name> [--about=<about>] [--picture=<picture>] [--nip05=<nip05>] [--banner=<banner>] [--lud16=<lud16>] [--website=<website>]
  noscl profile [--verbose] [--json] <pubkey>
  noscl follow <pubkey> [--name=<name>]
  noscl unfollow <pubkey>
  noscl following
  noscl event view [--gopher] [--verbose] [--json] <id>
  noscl event delete <id>
  noscl share-contacts
  noscl key-gen
  noscl relay
  noscl relay add <url>
  noscl relay remove [--all]
  noscl relay remove <url>
  noscl relay recommend <url>

Specify <content> as '-' to read from stdin.

1. Add relays: noscl relay add wss://relay.damus.io
2. Generate a key: noscl key-gen
3. Set private key: noscl setprivate <hex-or-nsec>
4. Follow users: noscl follow <pubkey> [--name=<name>]
5. Run TUI or CLI: noscl tui or noscl home

noscl tui launches an interactive interface with:

• Home (notes only) / Home (notes + replies) / Inbox
• Relay management
• Following list
• Set private key

Controls: j/k up/down, enter open, r refresh, tab switch feed, u back, q quit.

Gostr can format Nostr data as RFC 1436 Gopher protocol output. Use --gopher with home, inbox, or event view to get menu-style lines instead of plain text. This lets you pipe Nostr feeds into Gopher servers or serve them over the classic pre-web protocol.

noscl home --gopher
noscl inbox --gopher

• Original noscl by fiatjaf
• Gostr fork and extensions by k4lb1

This project is released into the public domain. See LICENSE.

Original noscl by fiatjaf is licensed under PDDL (Public Domain Dedication and License). Gostr is a derivative work.

Direct dependencies and their licenses:

Full dependency tree and licenses can be verified with:

go list -m all

See NOTICE for attribution details.