NTLx/ServerFS_MCP / skills/serverfs-agent-bridge
serverfs-agent-bridge
VerifiedOperate the ServerFS Host Bridge lifecycle for Agent delegation and/or v0.23 Repo Ops transport; manage native/ACP runtimes, proxy/Jev behavior, or Bridge/task failures.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.9 KB |
| references/linux.md | markdown | 3.7 KB |
| references/macos.md | markdown | 2.2 KB |
| references/windows.md | markdown | 1.9 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.
Agent workdir/runtime policy lives in `serverfs.toml`. Private derived Bridge state stays outside exposed workdirs. v0.23.1+ supports validated native Apple Silicon macOS Deterministic Repo Ops through the same authenticated Bridge transport, while keeping Repo Ops policy independently gated from Agent delegation. Use supported commands:
```bash
serverfs agent-bridge configure --config serverfs.toml --env-file .env
serverfs agent-bridge restart --config serverfs.toml --env-file .env
serverfs service status
serverfs doctor --config serverfs.toml
```
Persistent Bridge ownership is through the app-associated current-user ServiceManagement lifecycle. Do not resurrect the retired `serverfs agent-bridge install` path or hand-install legacy LaunchAgent plists.
On current macOS lifecycle builds, `serverfs agent-bridge restart` completes any requested policy/private-state synchronization in the caller and then schedules a bounded one-shot hand-over to restart only the Bridge. The caller may lose its current Agent session while the Bridge is replaced. Reconnect and use native `serverfs service status`; treat the restart as complete only when `handover.complete=true`, `handover.ok=true`, `handover.job_loaded=false`, and `handover.plist_exists=false`.
Respect Login Items/TCC user decisions; do not bypass them.
ACP v1 profiles are included in released v0.19.0. See the [ACP Guide](https://ntlx.github.io/ServerFS_MCP/docs/acp/) for the full workflow. Profiles are operator-owned absolute executable paths with fixed argv, configured through `[[agent.acp_profiles]]`; task callers cannot override command/argv/environment. Require explicit `workspace-write` workdir authorization. Runtime listing/probe must not launch the Agent. ACP task children use POSIX process-group stop semantics; retain the recovery guard and writer lease if stopping the group cannot be proven. OpenCode 2.1.2 acceptance is recorded across Linux, macOS, and Windows; do not generalize that evidence to all ACP Agents or versions.
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 |