NTLx/ServerFS_MCP / skills/serverfs-tunnel
serverfs-tunnel
VerifiedOperate optional OpenAI Secure MCP Tunnel and Linux/macOS/Windows Cloudflare ingresses while preserving independent service owners.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.4 KB |
| references/cloudflare-linux.md | markdown | 3.4 KB |
| references/cloudflare-windows.md | markdown | 4.9 KB |
| references/linux.md | markdown | 1.7 KB |
| references/macos.md | markdown | 2.6 KB |
| references/windows.md | markdown | 2.0 KB |
references/macos.md
View on GitHub# macOS native
Use this branch after the source-resolution and preflight gates in `SKILL.md`. Repository paths and command examples refer to the located checkout/deployment; confirm syntax and settings against its current CLI, templates and guide before execution.
Use the current ServerFS bootstrap and ServiceManagement lifecycle:
```bash
serverfs bootstrap tunnel-client
serverfs service status
serverfs service restart
```
The persistent Tunnel is an app-associated per-user LaunchAgent owned through `SMAppService`. Do not replace it with a root LaunchDaemon or unmanaged hand-installed plist.
If status requires Login Items approval, surface the user action and use `serverfs service open-settings` when requested; do not bypass it.
## Native Cloudflare (v0.24.1)
The existing OpenAI Tunnel remains the normal persistent native Tunnel path. Cloudflare is a distinct opt-in HTTP-origin/Connector pair, available in v0.24.1 on supported native Apple Silicon/macOS 27. Read `deployment/macos/README.md` for its complete setup and acceptance procedure. v0.24.2 adds Windows Cloudflare; see the Windows branch and its runbook.
The verified CLI syntax is `serverfs bootstrap cloudflare-client [--artifact PATH]`; install requires `--config`, `--cloudflared`, `--token-file`, `--env-file`, `--http-port`, and `--hostname` under `serverfs service cloudflare install`. `status`, `start`, `stop`, `restart`, and `uninstall` take no additional arguments. Never place secret values in argv. The connector Token and origin env file must each be current-user regular files mode `0600`, outside the checkout and all workdirs. Released v0.24.1/v0.24.2 installers require read-only Cloudflare workdirs. The **unreleased v0.24.3 candidate** accepts explicit writable workdirs using the same native `serverfs.toml` permissions as the OpenAI Tunnel; `read_only` still defaults to true, and Agent/Repo Ops remain separate opt-ins. The installer continues to require at least one workdir, exact equality between the hostname and `SERVERFS_HTTP_ALLOWED_HOSTS`, and exactly one independent caller-auth mode (ServerFS API Key or OAuth); the Connector Token is not caller authentication. For deliberate parity, verify both native frontends use the same canonical config and synchronized shared Agent Bridge/lease; preserve the original OpenAI Tunnel and Bridge until public writable/Agent E2E passes. Never treat a code-only test as production acceptance. After a Connector-only restart, establish a fresh MCP session and verify tools; an old session may return 404, and SSE replay is not guaranteed. Keep Cloudflare service health and credentials distinct from OpenAI Tunnel health and credentials.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |