A powerful Nostr CLI tool for creating and managing various types of Nostr events. I built this in order to test the Alexandria web app. It uses the PHP Helper library, as well as Monolog, Doctrine, and Symfony Console.

Please note that only tagged versions work, as I build on the master branch.

• Core Functionality

  • Create and manage various Nostr event types
  • Support for NIP-01 through NIP-98 and NKBIP-01 through NKBIP-06
  • Event signing and verification
  • Event filtering, deleting, broadcasting and replacing/republishing
  • Relay communication and authentication, for websockets and HTTP

• Event Types

  • Notes and replies
  • Calendar events (date and time-based)
  • Articles (wiki, longform, publications)
  • Citations and highlights
  • Repository management (ngit)
  • Relay information and management

• Advanced Features

  • Hierarchical command structure with subcommands
  • Comprehensive help system with command documentation
  • Shell completion support (bash and zsh)
  • Event conversion utilities (hex/bech32)

• Relay Management

  • Relay testing and information retrieval
  • Relay authentication (NIP-98)
  • Relay configuration management
  • Rate limiting and error handling

• Database Integration

  • SQLite with Doctrine
  • Event storage and retrieval
  • Query optimization
  • Database statistics and cleanup
  • Event indexing and search

• Logging and Monitoring

  • Detailed logging with Monolog
  • Multiple log levels and handlers
  • Performance monitoring
  • Error tracking and reporting

• Security Features

  • Secure key management
  • Event signature verification
  • Authentication header validation
  • Rate limiting protection

• Developer Tools

  • Command-line interface
  • Integration test suite
  • Database schema management

• Content Management

  • MIME type support
  • Category management
  • Tag system
  • Content validation

• Documentation

  • Comprehensive command reference
  • Installation guides
  • Usage examples
  • Troubleshooting guides

# Install Sybil
curl -sSL https://raw.githubusercontent.com/silberengel/sybil/main/bin/install.sh | bash

# Set your Nostr key
export NOSTR_SECRET_KEY=your_private_key_here

# Create a note
sybil note "Hello, Nostr!"

• Installation Guide
• Basic Usage
• Event Types
• Relay Authentication
• MIME Types and Categories
• Command Reference
• Troubleshooting
• Scriptorium Converter
• Database Documentation

For support, please:

1. Check the Sybil wiki page
2. Open an issue
3. Contact the developer directly: Silberengel on Nostr

GNU General Public License v3.0 - see LICENSE for details.