Skip to content

NTLx/ServerFS_MCP / skills/serverfs-tunnel

serverfs-tunnel

Verified

Operate optional OpenAI Secure MCP Tunnel and Linux/macOS/Windows Cloudflare ingresses while preserving independent service owners.

FileKindSize
SKILL.mdskill md9.4 KB
references/cloudflare-linux.mdmarkdown3.4 KB
references/cloudflare-windows.mdmarkdown4.9 KB
references/linux.mdmarkdown1.7 KB
references/macos.mdmarkdown2.6 KB
references/windows.mdmarkdown2.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.
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall