Holepunch P2P Development Marketplace

A Claude Code marketplace providing plugins for building zero-infrastructure peer-to-peer applications using the Holepunch ecosystem.

Installation

From GitHub Marketplace

# In Claude Code, install the marketplace and plugin:
# "Install holepunch from github:grandcamel/holepunch-plugin"

Manual Installation

# Clone the repository
git clone https://github.com/grandcamel/holepunch-plugin.git

# Use with Claude Code
claude --plugin-dir ./holepunch-plugin/plugins/holepunch

Plugins

holepunch

Build zero-infrastructure P2P applications with the Holepunch ecosystem.

Features:

• Skill: Comprehensive guidance for Holepunch/Pear development
• Commands: Scaffold apps, debug issues, select modules
• Agents: Proactive code review and troubleshooting

Skill: Holepunch P2P Development

Activates when you:

• Ask to "create a P2P app" or "build with Holepunch"
• Mention Hypercore, Hyperswarm, Hyperdrive, Hyperbee
• Work with Pear, Bare, HyperDHT, Autobase, or Corestore

Commands

Command	Description
/holepunch:scaffold	Create new Pear desktop/terminal app
/holepunch:debug	Debug P2P connectivity issues
/holepunch:modules	Quick module selection guide

Agents

Agent	Triggers When
p2p-code-reviewer	Reviewing code with Holepunch imports
p2p-troubleshooter	Debugging P2P connectivity/replication issues

Module Quick Reference

Need	Module
Find peers by topic	Hyperswarm
Direct P2P connection	HyperDHT
Append-only log	Hypercore
Key-value database	Hyperbee
P2P filesystem	Hyperdrive
Multiple writers	Autobase
Manage many cores	Corestore

Project Structure

holepunch-plugin/
├── .claude-plugin/
│   └── marketplace.json      # Marketplace metadata
├── plugins/
│   └── holepunch/
│       ├── .claude-plugin/
│       │   └── plugin.json   # Plugin metadata
│       ├── commands/         # Slash commands
│       ├── agents/           # Autonomous agents
│       └── skills/
│           └── holepunch/    # P2P development skill
│               ├── SKILL.md
│               ├── references/
│               ├── examples/
│               └── scripts/
├── CLAUDE.md                 # Development guidelines
├── README.md
├── LICENSE
└── VERSION                   # Semver version tracking

Examples

Working examples in plugins/holepunch/skills/holepunch/examples/:

• hyperswarm-basic.js - Peer discovery and messaging
• hypercore-replication.js - Data sharing between peers
• hyperdrive-files.js - P2P file sharing

Reference Documentation

Detailed docs in plugins/holepunch/skills/holepunch/references/:

• modules.md - Complete module API reference
• platforms.md - Desktop, terminal, mobile guidance
• debugging.md - Troubleshooting guide
• best-practices.md - Patterns, security, performance

NotebookLM Integration

For deeper API documentation, query your Pear P2P Platform notebook:

"Ask my Pear notebook about Autobase linearization"
"What does my P2P docs say about Hypercore manifests?"

Resources

• Pear Documentation
• Holepunch Documentation
• GitHub

License

MIT