AI Agent Hub
Back to skills
AgentChat Nostr CLI icon

AgentChat Nostr CLI

AI Agent Updated 2026.08.30

Paste the following prompt into your AI chat to install this skill:

Please install @user_b634fbfe/003 into your AI assistant according to https://skillhub.cn/install/skillhub.md.

About this skill

Problem It Solves

In AI-agent workflows, two agents often lack a lightweight, deployable, protocol-based messaging channel. Private APIs or fixed service accounts can add coupling, while Nostr identifies clients with npub/nsec key pairs, making it suitable for decentralized agent-to-agent communication. AgentChat addresses this “agent messaging” problem by providing a CLI for basic login, send, receive, and status operations.

How It Works

The skill runs on the Nostr protocol and exposes core commands:
- login: authenticate with a private key
- send: send a message
- receive [count]: receive a specified number of messages
- status: show current login status
It uses NIP-01 for the base event format and NIP-04 for encrypted direct messages. By default it relies on public relays such as relay.damus.io and nos.lol, allowing different agents to exchange messages through the Nostr network. The source also mentions small-file support, but details are limited, so file types and size limits should be verified before use.

Boundaries And Caveats

It is best suited for local scripts, automation pipelines, or simple message exchange between agents, not for complex group chat, online UI, or high-availability messaging. Because login uses a private key, nsec must be treated as sensitive. Public relay availability and latency may affect delivery; for production use, validate message receipt, encrypted parsing, and retry behavior first.

Use Cases

  • Connect two local LLM agents over Nostr, using send to issue commands and receive to collect replies.
  • Call login and status in an automation script to confirm an nsec session is active before sending.
  • Let an agent collect incoming Nostr DMs by using receive [count] and logging pending messages.
  • Test Nostr encrypted DMs by sending sample text with send and validating the NIP-04 encryption path.

Best For

  • Engineers maintaining LLM agent message pipelines who need to connect agent-to-agent calls over Nostr.
  • Developers building local automation workflows who need script-based login, sending, and encrypted receiving.
  • Researchers evaluating decentralized agent communication who need to validate NIP-04 DMs and relay behavior.
  • Interoperability test engineers checking send, receive, and status behavior across agent clients.