Sigil Nostr — P2P Encrypted Messaging for AI Agents#

Give your AI agent a Nostr identity. Users can message your agent from Sigil Messenger, Damus, Primal, or any Nostr client — all E2E encrypted.

What This Does#

• Creates a persistent Nostr keypair for your agent (~/.sigil/.key)
• Connects to Nostr relays and listens for NIP-04 encrypted DMs
• Routes incoming messages to your agent, sends replies back via Nostr
• Supports TUI components (buttons, cards, tables) for rich responses
• Personal agent mode: only whitelisted npubs can interact

Quick Start#

1. Install Sigil CLI#

bash

cargo install --git https://github.com/lmanchu/sigil sigil-cli

2. Start as Agent Bridge#

The simplest way — pipe messages between Nostr and your agent:

bash

# Generate agent identity
sigil whoami

# Your agent's npub is shown — users can DM this to reach your agent
# Add your npub to the access whitelist:
# Edit ~/.sigil/<agent>.access.json → add npub to "authorized" array

3. Use from OpenClaw / Hermes#

This skill works with both OpenClaw and Hermes agent frameworks.

OpenClaw: Add to your openclaw.json channels config:

json

{
  "channels": {
    "nostr": {
      "enabled": true,
      "relay": "wss://relay.damus.io",
      "dmPolicy": "personal",
      "allowFrom": ["npub1yourownpubkey..."]
    }
  }
}

Hermes: Install as a skill:

bash

# Copy this skill directory to ~/.hermes/skills/sigil-nostr/
cp -r skills/sigil-nostr ~/.hermes/skills/

Connect from Sigil Client#

Once your agent bridge is running, users connect from any of these clients:

iPhone / iPad (Sigil Messenger)#

1. Download Sigil Messenger from the App Store
2. Tap Add Contact (person+ icon)
3. Choose Scan QR Code — scan the agent's QR, or
4. Choose Add Manually — paste the agent's npub
5. Start chatting — messages are E2E encrypted

Terminal (sigil-cli)#

bash

cargo install --git https://github.com/lmanchu/sigil sigil-cli

# Add your agent
sigil add sigil://agent?npub=<AGENT_NPUB>&relay=wss://relay.damus.io&name=MyAgent

# Start chatting
sigil

Mac (Catalyst)#

Same app as iOS — build from source with Xcode or install via sigil-cli. Link Mac to iPhone by scanning QR code (Mac shows QR, iPhone scans).

Any Nostr Client (Damus, Primal, Amethyst)#

Your agent is a standard Nostr identity. Send a NIP-04 DM to the agent's npub from any Nostr client. TUI components (buttons, cards) only render in Sigil — other clients show raw JSON.

Sharing Your Agent#

Every agent gets a shareable QR code and sigil:// URI:

bash

sigil qr  # prints sigil://agent?npub=...&relay=...&name=...

Share this URI or QR — anyone who scans it gets your agent added instantly.

Architecture#

text

User (Sigil/Damus/Primal)
    ↓ NIP-04 Encrypted DM
Nostr Relay (relay.damus.io)
    ↓ WebSocket
Sigil Bridge (this skill)
    ↓ stdin/stdout or HTTP
Your Agent (OpenClaw / Hermes / Custom)

Agent Bridge Script#

For standalone use, run the bridge directly:

bash

# Start the Nostr bridge for your agent
cd /path/to/sigil
cargo run --example hermes_bridge

Or use the Node.js bridge for OpenClaw integration:

bash

node skills/sigil-nostr/bridge.js

Security#

• Personal mode (default): only owner + authorized npubs can interact
• Service mode: open to anyone (like a LINE official account)
• Rate limiting: 10 messages/minute per sender
• Event dedup: prevents relay replay attacks
• Key encryption: sigil encrypt-key for passphrase protection

Configuration#

Config file: ~/.sigil/<agent-name>.access.json

json

{
  "mode": "personal",
  "owner": "npub1...",
  "authorized": ["npub1friend1...", "npub1friend2..."],
  "reject_message": "This is a personal agent. Contact the owner for access."
}

TUI Messages#

Your agent can send rich interactive messages:

json

{"type": "buttons", "text": "What do you need?", "items": [
  {"id": "search", "label": "Search", "style": "primary"},
  {"id": "help", "label": "Help", "style": "secondary"}
]}

Supported types: text, buttons, card, table

When a user taps a button, your agent receives: sigil:callback:<button_id>

Links#

• Sigil GitHub
• Landing Page
• Sigil Messenger on App Store (pending review)
• Agent Registry (kind:31990)