# Local Server

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

- Skill: `aiagentwithdhruv/local-server` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aiagentwithdhruv/local-server`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiagentwithdhruv/local-server/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiagentwithdhruv (https://skillmd.com/u/aiagentwithdhruv)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/aiagentwithdhruv/local-server

---


# Local Server Execution

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

## Start Server
```bash
python3 execution/local_server.py
```

Starts FastAPI server on port 8000.

## Cloudflare Tunnel
For external access (webhooks), use Cloudflare tunnel:
```bash
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
| Name | Type | Required | Description |
|------|------|----------|-------------|
| `port` | integer | No | Server port (default: 8000) |

### Outputs
| Name | Type | Description |
|------|------|-------------|
| `server_url` | string | Local server URL (http://localhost:8000) |
| `tunnel_url` | string | Cloudflare tunnel URL (if enabled) |

### Composable With
Skills that chain well with this one: `add-webhook`

### Cost
Free (local execution)