About local-server
local-server runs the Claude orchestrator locally and can use a Cloudflare tunnel for external webhook access. It is intended for development and debugging, using local files, credentials, and a `.env` file.
Key features
- 01Run a FastAPI server locally
- 02Expose directive, webhook-list, and agent-task endpoints
- 03Use Cloudflare tunnel for external access
- 04Use local files, credentials, and `.env` directly
- 05Configure the port, defaulting to 8000
Use cases
- 01Iterate on the Claude orchestrator locally
- 02Debug webhook-related flows
- 03Run directives or general agent tasks locally
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/local-serverin Claude Code to confirm it loaded.
Details
From the project READMELocal 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
| 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)
Comments
Markdown supported