Guide

Getting Started

Get started with eve-preflight in less than 60 seconds with zero configuration.

1

Run via npx (Zero Install)

Run eve-preflight directly inside your Eve project directory:

$ npx eve-preflight

Alternatively, install globally if preferred: npm install -g eve-preflight

2

The Two-Terminal Workflow

Because Eve's Nitro server serves on port 3000, eve-preflight sits in front on port 3001:

Terminal 1 (Eve Agent)

Start your agent dev server:

$ npx eve dev
✓ Ready on http://localhost:3000
Terminal 2 (Preflight Proxy)

Start preflight inspector:

$ npx eve-preflight
✓ Proxying http://localhost:3001 → :3000
3

First Successful Run

On startup, preflight queries eve info --json, prints your discovered channels, and starts logging requests:

[eve-preflight] Preflight Proxy started
Listening on : http://localhost:3001
Forwarding to: http://localhost:3000
Registered Eve Channels:
- POST /api/channels/web
- POST /api/channels/slack
Send incoming webhooks or connectors to http://localhost:3001 to audit delivery.