// Run user-created frontend or backend services in the background and optionally expose them through a Cloudflare Quick Tunnel.
| name | service_expose |
| description | Run user-created frontend or backend services in the background and optionally expose them through a Cloudflare Quick Tunnel. |
| version | 1.0.0 |
| author | XSpoon Team |
| tags | ["service","frontend","backend","cloudflare","tunnel","background"] |
| triggers | [{"type":"keyword","keywords":["background service","run service","expose service","cloudflare tunnel","trycloudflare","frontend preview","backend preview"],"priority":90}] |
| scripts | {"enabled":true,"definitions":[{"name":"service_expose","description":"Start, stop, inspect, log, and Cloudflare-expose local frontend/backend services.","type":"python","file":"scripts/service_expose.py","timeout":60,"input_schema":{"type":"object","properties":{"action":{"type":"string","description":"start, tunnel, status, list, logs, stop, or stop_tunnel"},"name":{"type":"string","description":"Stable service name"},"command":{"type":"string","description":"Command to run for action=start"},"cwd":{"type":"string","description":"Working directory for the service command"},"port":{"type":"integer","description":"Local port to expose"},"host":{"type":"string","description":"Local host, default 127.0.0.1"},"url":{"type":"string","description":"Full local URL to expose, for example http://127.0.0.1:3000"},"start_tunnel":{"type":"boolean","description":"Start Cloudflare tunnel after service start"},"replace":{"type":"boolean","description":"Stop and replace an existing process with the same name"},"tail_chars":{"type":"integer","description":"Log tail size"}},"required":["action"]}}]} |
Use this skill when a user-created frontend or backend needs to keep running after the turn and be reachable through Cloudflare.
Prefer service_expose over one-off shell backgrounding for preview services because it persists service metadata, log paths, PIDs, local URLs, and tunnel URLs under ~/.spoon-bot/service-expose.
start: run a service command in the background. Include name, command, and usually cwd plus port or url.tunnel: start a Cloudflare Quick Tunnel for an existing service or an explicit local url.status / list: inspect running services and tunnel URLs.logs: return recent service or tunnel logs.stop / stop_tunnel: stop the background service or only its Cloudflare tunnel.Use replace=true only when the user wants to restart/replace the existing named service. Quick Tunnels require cloudflared in PATH or CLOUDFLARED_PATH.
Cloudflare Quick Tunnels are for development previews. For production or stable hostnames, use a named Cloudflare Tunnel outside this quick-preview skill.
Use when working with spoon-bot's built-in EVM wallet, checking balances, transferring EVM assets, signing messages or transactions, rotating/exporting keys, or supporting skills that expect the legacy ~/.agent-wallet layout.
Search, install, and remove Agent Skills from skills.sh or confirmed skill GitHub sources
Use when creating, listing, steering, cancelling, or resuming spoon-bot persistent subagents through explicit tools or API calls.
A skill for performing automated code reviews with security and best practices analysis
A skill for automating common Git operations with safety checks
Export text content to various formats (PDF, Excel, Markdown, Mermaid mindmap)