What it does
Private mesh VPN for humans and agents. Local keys, signed enrollment, no provider account. Native apps and CLI.
- Connects Instruction files the AI reads
- Account or key No key found in README or SKILL.md
- Category Automatisierung und Agenten
Für Anbieter: Badge ins README
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/skills/mmalmi-nostr-vpn)Ähnliche Skills
Gleiche Art Arbeit, sortiert wie die Skill-Liste
1 Skills (Anweisungssammlungen) von mmalmi, die eine KI liest und befolgt · kein MCP-Server
Was einen Skill von MCP unterscheidet
MCP = die Hände
Verbindet die KI mit einem externen Dienst oder Daten, etwa Notion lesen oder eine Rechnung erstellen. Ein Programm oder Server muss laufen.
Skill = das Handbuch
Eine Textdatei, die der KI zeigt, wie eine Aufgabe geht. Sie verbindet sich mit nichts.
Manches überschneidet sich: Einige Skills starten Skripte mit Werkzeugen, einige MCP-Server liefern nur Wissen. Geh von der Aufgabe aus.
Funktioniert mit
Vom Anbieter nicht angegeben · SKILL.md-Skills laufen in Apps mit Agent-Skills-Unterstützung wie Claude Code, Codex und Cursor
Installieren
Is it safe?
- Who made it
GitHub account mmalmi (person), 14 years old
- Use and upkeep
★ 1.252 stars · code last changed 18. Nov. 2026
- Any scripts?
No, plain text files the AI reads and follows
- Uses the internet?
No scripts, so it does not go online by itself
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 827bcee (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
Zuerst: Welche KI nutzt du?
Wähle deine App, dann zeigt diese Seite nur die Installation für diese App
Option 1Upload to claude.ai (web and app)
Uploading to claude.ai would fail: the description is over 200 characters (206). Use "Let the AI install it" instead
Option 1Claude Code installieren lassen
Kopiere diesen Satz und füge ihn in einen Claude Code-Chat ein
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code neu starten, dann /nostr-vpn tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill
Checked against official docs 12. Nov. 2026 · Source: code.claude.com
For Terminal users
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.claude/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
git clone --depth 1 https://github.com/mmalmi/nostr-vpn.git /tmp/popnx-skill-mmalmi-nostr-vpn-827bcee && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-mmalmi-nostr-vpn-827bcee/plugins/nostr-vpn/skills/nostr-vpn' ~/.claude/skills/nostr-vpnClaude Code neu starten, dann /nostr-vpn tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill
Selbst installierte Skills funktionieren in der ChatGPT-Desktop-App, in Codex CLI und in der Codex-Erweiterung für die IDE · ChatGPT im Web und auf dem Handy kann selbst installierte Skills nicht nutzen, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen
ChatGPT-Desktop-App
Die ChatGPT-Desktop-App enthält Codex, und Codex liest Skills aus dem Ordner ~/.agents/skills
Option 1ChatGPT installieren lassen
Öffne Codex in der ChatGPT-Desktop-App und füge diesen Satz in den Chat ein
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Ordner selbst ablegen
Lege den Ordner nostr-vpn unter ~/.agents/skills/nostr-vpn ab
~ ist dein Home-Ordner ($HOME)
For Terminal users
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.agents/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
git clone --depth 1 https://github.com/mmalmi/nostr-vpn.git /tmp/popnx-skill-mmalmi-nostr-vpn-827bcee && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-mmalmi-nostr-vpn-827bcee/plugins/nostr-vpn/skills/nostr-vpn' ~/.agents/skills/nostr-vpn
Nach der Installation
- ChatGPT-Desktop-App: Öffne Skills in der Seitenleiste, um zu sehen, ob der Skill da ist
- So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
- Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
ChatGPT im Web und auf dem Handy
Selbst installierte Skills funktionieren hier nicht, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen
Um diesen Skill mit ChatGPT zu nutzen, verwende die ChatGPT-Desktop-App wie oben beschrieben
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
Option 1Codex installieren lassen
Kopiere diesen Satz und füge ihn in einen Codex-Chat ein · Funktioniert in Codex in der ChatGPT-Desktop-App, in Codex CLI und in der IDE-Erweiterung
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu · So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
For Terminal users
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.agents/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
git clone --depth 1 https://github.com/mmalmi/nostr-vpn.git /tmp/popnx-skill-mmalmi-nostr-vpn-827bcee && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-mmalmi-nostr-vpn-827bcee/plugins/nostr-vpn/skills/nostr-vpn' ~/.agents/skills/nostr-vpnCodex neu starten und eine passende Aufgabe stellen; Codex listet den Skill
Option 1Cursor installieren lassen
Kopiere diesen Satz und füge ihn in einen Cursor-Chat ein
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Im Agent-Chat von Cursor / tippen und nostr-vpn wählen
Checked against official docs 12. Nov. 2026 · Source: cursor.com
For Terminal users
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.cursor/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
git clone --depth 1 https://github.com/mmalmi/nostr-vpn.git /tmp/popnx-skill-mmalmi-nostr-vpn-827bcee && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-mmalmi-nostr-vpn-827bcee/plugins/nostr-vpn/skills/nostr-vpn' ~/.cursor/skills/nostr-vpnIm Agent-Chat von Cursor / tippen und nostr-vpn wählen
Option 1Let the AI install it
Für andere Apps, die Skills lesen. Der Satz enthält die Pfade für Claude Code, Codex und Cursor, damit die KI den für deine App wählt · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 12. Nov. 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Andere Apps mit Agent Skills (etwa Gemini CLI oder GitHub Copilot) nutzen andere Ordner. Sieh in deren Anleitung nach und kopiere den Ordner mit der SKILL.md dorthin.
Skill-Ordner am 11. Nov. 2026 mit den offiziellen Anleitungen von Claude Code, Codex und Cursor geprüft
✓ Befehle geprüft am 17. Nov. 2026
Original-SKILL.md ansehen
Der folgende Text stammt aus dem Repo des Anbieters, nicht von PopNx MCP
4.341 Zeichen · Ganze Datei auf GitHub öffnen
---
name: nostr-vpn
description: Connect an authorized machine to a Nostr VPN private mesh, review device join requests, and verify access with the nvpn CLI. Use for account-free private networking between agent hosts, people, and servers.
---
# Nostr VPN
Use the `nvpn` CLI for private networking without a VPN provider account.
Every device retains its own identity; network membership still needs an
administrator's approval. This workflow does not require paid exits.
## Establish the execution context
- Run `nvpn --version`, `nvpn join-requests --help`, and
`nvpn join-request --help`. CLI approval and JSON join-request output are
currently source-only and have not yet shipped in a release. Install a matching
binary from https://github.com/mmalmi/nostr-vpn/releases/latest or use
`cargo install nvpn`. Check the release's supported architecture.
- Choose an explicit, persistent absolute config path and pass `--config` on
every command, including elevated ones. Reuse a designated profile; never
overwrite an existing one with `init --force`.
- A Linux tunnel needs network privileges, `/dev/net/tun`, and `iproute2`;
containers need `NET_ADMIN` and the TUN device. macOS/Windows need elevated
platform networking setup. A cloud terminal or plugin does not confer this
access. If unavailable, report that specific limitation and use an authorized
machine with those capabilities.
- Persist config and key sidecars privately. Give separate devices separate
keys. Do not print private keys, copy the admin identity to a joining device,
or put join links into public output.
## Create or join
On a new admin host, run `nvpn init --config "$NVPN_CONFIG"`, then use the
printed public `nostr_pubkey` with
`nvpn set --config "$NVPN_CONFIG" --device "$ADMIN_DEVICE_ID"`.
Start it with `nvpn start --config "$NVPN_CONFIG" --daemon --connect`.
On the joining host, initialize its own config and start its daemon the same
way, then run `nvpn join-request --config "$NVPN_CONFIG" --json`. The
`join_request` field contains the link to share with the intended admin through
the user's selected channel. JSON output returns immediately and does not
resume a paused daemon. Keep the daemon connected; obtain a fresh link if a
macOS/Linux joining daemon restarts.
On the admin host, save the received link in a private file and run:
```sh
nvpn join-requests inspect --request-file "$REQUEST_FILE" --json
```
Inspection is read-only. Check the returned device ID with the intended joiner;
the supplied name alone is not proof. When admission of that device to the
config's active network is authorized, run:
```sh
nvpn join-requests approve --config "$NVPN_CONFIG" \
--request-file "$REQUEST_FILE" --json
```
This signs the roster, queues delivery, and resumes an already-running paused
admin daemon. If it is stopped, start it. `delivery: queued` is not a delivery
receipt. Keep both daemons connected until the joiner receives approval.
For inbound manual-join requests, use
`nvpn join-requests list --config "$NVPN_CONFIG" --json`, then approve exactly
the selected pending ID with `join-requests approve --device "$DEVICE_ID"` and
the same config. Shared links need not appear in that list.
If the installed CLI lacks `join-requests` or `join-request --json`, use the
interactive `join-request` and the native admin app's **Devices → Add Join
Request**, or build current source with
`cargo install --locked --path crates/nostr-vpn-cli` from its checkout. Do not
substitute private-key sharing or manual signed-roster edits.
## Verify the requested result
Run `nvpn status --config "$NVPN_CONFIG" --json`. Interpret readiness only when
`status_source` is `daemon`; config-only readiness is unknown. Use
`nvpn ip --config "$NVPN_CONFIG" --peer --json` and
`nvpn ping --config "$NVPN_CONFIG" "$PEER_TUNNEL_IP"`, then access the actual
service the user requested using its normal authentication. Report queued
approval, mesh reachability, DNS, and service access separately when they differ.
Avoid changing default routes, selecting paid exits, or spending funds unless
that is part of the user's request. Stop only a daemon started for a temporary
task with `nvpn stop --config "$NVPN_CONFIG"`; preserve existing services.
Detailed guide: https://github.com/mmalmi/nostr-vpn/blob/master/docs/agents.md
Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Von GitHub
- GitHub-Sterne
- 1.252
- Anbieter
- mmalmi
- Lizenz
- MIT
- Letzte Codeänderung
- 18. Nov. 2026
- SKILL.md-Dateien im Repo (mit Übersetzungen und Vorlagen)
- 1
- Themen
- agent-skills, ai-agents, mesh-network, nostr, vpn
- Repo
- mmalmi/nostr-vpn