Agent skill
zrok
Share local services publicly or privately via secure tunnels. Use when needing to expose localhost ports, share dev servers, create public URLs for local services, or set up secure tunnels between machines.
Install this agent skill to your Project
npx add-skill https://github.com/mrud/skills/tree/main/zrok
SKILL.md
zrok - Secure Sharing
Share local services via secure tunnels using a self-hosted zrok instance.
Quick Reference
| Command | Description |
|---|---|
zrok share public http://localhost:PORT |
Share publicly, get https URL |
zrok share private http://localhost:PORT |
Share privately, get token |
zrok access private TOKEN |
Connect to private share |
zrok status |
Check current configuration |
zrok reserve public --unique-name NAME |
Reserve persistent subdomain |
Public Sharing
Expose a local service with a public HTTPS URL:
# Share a web server
zrok share public http://localhost:3000
# Returns: https://xyz123.z.spamt.net
# Share a directory as file server
zrok share public --backend-mode web /path/to/files
# Share with reserved name (persistent URL)
zrok reserve public http://localhost:3000 --unique-name myapp
zrok share reserved myapp
# Always: https://myapp.z.spamt.net
Private Sharing
Share only with other zrok users (end-to-end encrypted):
# Machine A - share
zrok share private http://localhost:3000
# Returns token: abc123xyz
# Machine B - access
zrok access private abc123xyz
# Creates: http://127.0.0.1:9191 -> Machine A's localhost:3000
Setup New Machine
# Install (macOS)
brew install zrok
# Install (Linux)
curl -sSLf https://get.openziti.io/install.bash | sudo bash -s zrok
# Configure endpoint (one-time)
zrok config set apiEndpoint https://z.spamt.net
# Enable with account token (one-time per machine)
# Get token from admin or web console
zrok enable <token>
Web Console
https://z.spamt.net - View active shares, manage account, get enable tokens
Troubleshooting
# Check if enabled
zrok status
# Re-enable if issues
zrok disable
zrok enable <token>
# Verify connectivity
curl https://z.spamt.net/api/v1/version
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
taskwarrior
Track work items using Taskwarrior. Use when managing tasks, tracking PRs, or organizing work. Always use UUID instead of task ID.
oracle
Run long AI queries with Oracle CLI. Use for code reviews, summarization, or analysis that takes time. Always run in tmux.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
Didn't find tool you were looking for?