← Back to home

Obelisk Guides

Everything about Obelisk — what it is, how it works, and where it's going. Written plain, no jargon walls.

Admin CLI for coding agentsA terminal window streaming admin commands, wired to an AI agent avatar that signs Nostr challenges and drives the Obelisk admin API.obelisk admin cli$ npm run admin -- login --bunker bunker://...✓ authenticated as npub1agent…$ npm run admin -- servers list→ obelisk.ar · la-crypta · test-server$ npm run admin -- channels create sv1 …✓ #announcements createdAI agent/api/adminsigned with nsec / NIP-46role-checked endpointssame API as /admin

An admin CLI any coding agent can drive

Obelisk ships a headless admin CLI that authenticates with its own Nostr key and drives the same HTTP API the web admin panel uses. Give your Claude Code, Codex, or Cursor agent an admin account and it can run your server end-to-end.

#admin#cli#agents
Bitcoin zaps in chatA chat message with a glowing lightning bolt flowing into it, orbited by sat particles representing a Lightning zap sent over Nostr Wallet Connect.NWC wallet+21+42+63+84+105+126+147+168Lightning (NIP-47)chat message

Bitcoin zaps in chat

Obelisk lets you send Bitcoin over Lightning directly from a chat message using Nostr Wallet Connect (NIP-47). Here is how it works, what it costs, what stays private, and why the wallet stays entirely in your control.

#bitcoin#lightning#nwc
Future: Nostr relay-based groupsA mesh of Nostr relays exchanging encrypted group messages, with no central server.relay.arelay.brelay.crelay.drelay.erelay.fNIP-29 group

The future is relay-based groups

Obelisk today is a centralized server with Nostr login. The plan is to retire the centralized server and become a pure Nostr client on top of NIP-29 relay-managed groups, NIP-28 public channels, and NIP-59 gift-wrapped private groups.

#nostr#nip-29#decentralization
How Obelisk worksA browser client, Obelisk server, and Nostr relays connected with flowing data lines.SignClientObelisk serverChannels · Messages · RealtimeNostr relaysIdentity · Profilessession + messagessign kind 0 / auth challengeprofile fetch

How Obelisk works today

Obelisk is hybrid by design — Nostr handles identity, a server handles channels and realtime. Here is exactly what happens when you log in, send a message, and join a server.

#architecture#how-it-works
Web of Trust graphA trust graph with your node at the center, connected nodes in lime green for high trust, and red-outlined spam nodes at the periphery.YOU!!!direct followfriend-of-friendfiltered (spam)

Web of Trust — spam resistance without CAPTCHAs

How Obelisk uses your server's Nostr social graph to score every newcomer's trust, stop spam, and skip the "verify your email" step forever. A guide to the nostr-wot-extension model.

#wot#nostr#anti-spam
What is ObeliskAn obelisk monument surrounded by orbiting Nostr keys and floating chat bubbles.Kn

What is Obelisk?

Obelisk is a Discord-style group chat where your account is a Nostr keypair. No email, no password, no phone number — just cryptography. Here is what it is and why it matters.

#intro#nostr#identity