Learn-skills.dev local-server

Run Claude orchestrator locally with Cloudflare tunneling. Use when user asks to run locally, start local server, or test webhooks locally.

install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/aiagentwithdhruv/skills/local-server" ~/.claude/skills/neversight-learn-skills-dev-local-server && rm -rf "$T"
manifest: data/skills-md/aiagentwithdhruv/skills/local-server/SKILL.md
source content

Local Server Execution

Goal

Run the Claude orchestrator locally with Cloudflare tunnel for external webhook access.

Start Server

python3 execution/local_server.py

Starts FastAPI server on port 8000.

Cloudflare Tunnel

For external access (webhooks), use Cloudflare tunnel:

cloudflared tunnel --url http://localhost:8000

Endpoints

Same as Modal deployment:

  • /directive?slug={slug}
    - Execute directive
  • /list-webhooks
    - List webhooks
  • /general-agent
    - General agent tasks

Development Use

  • Faster iteration than Modal deploys
  • Full access to local files and credentials
  • Real-time debugging with print statements

Environment

Uses local

.env
file directly (unlike Modal which uses secrets).


Schema

Inputs

NameTypeRequiredDescription
port
integerNoServer port (default: 8000)

Outputs

NameTypeDescription
server_url
stringLocal server URL (http://localhost:8000)
tunnel_url
stringCloudflare tunnel URL (if enabled)

Composable With

Skills that chain well with this one:

add-webhook

Cost

Free (local execution)