nostr-direct-messages

Implement Nostr direct messaging with NIP-04 and NIP-17 encryption.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/feelancer21/nodestr --skill nostr-direct-messages-feelancer21
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nostr-direct-messages
Source: https://github.com/feelancer21/nodestr/tree/main/.claude/skills/nostr-direct-messages
Command: npx skills add https://github.com/feelancer21/nodestr --skill nostr-direct-messages-feelancer21

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables secure, end-to-end encrypted direct messaging on the Nostr protocol, facilitating private peer-to-peer communication.

Core Features & Use Cases

  • NIP-04 & NIP-17 Support: Implements both legacy (NIP-04) and modern, private (NIP-17) encryption standards.
  • Real-time Chat: Provides real-time message updates and subscriptions.
  • Cache-First UI: Ensures instant message loading from local storage.
  • File Sending: Allows users to send encrypted files along with messages.
  • Use Case: Build a fully functional chat application within a Nostr client, allowing users to exchange private messages and files securely.

Quick Start

Configure the DMProvider in your App.tsx with enabled: true and your desired protocolMode.

Frequently Asked Questions about nostr-direct-messages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement end-to-end encrypted Nostr direct messaging in my chat application?▼

To implement Nostr direct messaging, configure the DMProvider in your App.tsx with enabled set to true and your desired protocolMode. This enables secure peer-to-peer communication using NIP-04 and NIP-17 encryption standards.

What is the difference between NIP-04 and NIP-17 for Nostr private messaging?▼

NIP-04 is the legacy encryption standard for Nostr private messaging, while NIP-17 represents the modern approach. This Skill supports both protocols, allowing you to select your preferred protocolMode during DMProvider configuration.

Can I send encrypted files through Nostr peer-to-peer chat?▼

Yes, you can send encrypted files through Nostr peer-to-peer chat. The Skill provides specific hooks that allow users to send encrypted file attachments alongside their direct messages.

How do I handle real-time message subscriptions and optimistic UI updates for a Nostr client?▼

You handle real-time message subscriptions and optimistic UI updates using the Skill's dedicated hooks. These hooks manage real-time message delivery while utilizing a cache-first local storage approach to ensure instant UI loading.

Does Nostr direct messaging work offline or require a constant connection to load conversations?▼

Nostr direct messaging does not require a constant connection to load conversations because it uses a cache-first local storage system. This persistent cache ensures instant message loading from local storage before fetching real-time updates.