lindy-local-dev-loop
Set up local development workflow for testing Lindy AI agent integrations. Use when building webhook receivers, testing agent callbacks, or iterating on Lindy-connected applications locally. Trigger with phrases like "lindy local dev", "lindy development", "test lindy locally", "lindy webhook local".
- License 许可
- MIT
- 最近更新
- 2026-07-13
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- lindy-local-dev-loop
- tags
- [ "saas", "lindy", "testing", "workflow" ]
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Set up local development workflow for testing Lindy AI agent integrations. Use when building webhook receivers, testing agent callbacks, or iterating on Lindy-connected applications locally. Trigger with phrases like "lindy local dev", "lindy development", "test lindy locally", "lindy webhook local".
- allowed-tools
- Read, Write, Edit, Bash(npm:*), Bash(node:*), Bash(npx:*)
- compatible-with
- claude-code, codex, openclaw
03 SKILL.md 正文
Lindy Local Dev Loop
Overview
Lindy agents run on Lindy's managed infrastructure — you do not run agents locally. Local development focuses on building and testing the webhook receivers, callback handlers, and application code that Lindy agents interact with. Use ngrok or similar tunnels to expose local endpoints for Lindy webhook triggers.
Prerequisites
- Node.js 18+ or Python 3.10+
- ngrok or Cloudflare Tunnel for HTTPS tunneling
- Lindy account with at least one agent configured
- Completed
lindy-install-authsetup
Instructions
Step 1: Create Webhook Receiver
// server.ts — Express webhook receiver for Lindy callbacks
import express from 'express';
import dotenv from 'dotenv';
dotenv.config();
const app = express();
app.use(express.json());
const WEBHOOK_SECRET = process.env.LINDY_WEBHOOK_SECRET;
// Verify Lindy webhook authenticity
function verifyWebhook(req: express.Request): boolean {
const auth = req.headers.authorization;
return auth === `Bearer ${WEBHOOK_SECRET}`;
}
// Receive Lindy agent callbacks
app.post('/lindy/callback', (req, res) => {
if (!verifyWebhook(req)) {
console.error('Unauthorized webhook attempt');
return res.status(401).json({ error: 'Unauthorized' });
}
console.log('Lindy callback received:', JSON.stringify(req.body, null, 2));
// Process the agent's output
const { taskId, result, status } = req.body;
console.log(`Task ${taskId}: ${status}`);
res.json({ received: true });
});
// Health check for Lindy to verify endpoint
app.get('/health', (req, res) => res.json({ status: 'ok' }));
app.listen(3000, () => console.log('Webhook receiver running on :3000'));
Step 2: Expose Local Server via Tunnel
# Install and start ngrok
npm install -g ngrok
ngrok http 3000
# Output: https://abc123.ngrok.io -> http://localhost:3000
# Use this URL in Lindy webhook configuration
Step 3: Configure Lindy Agent to Call Your Endpoint
In the Lindy dashboard, add an HTTP Request action to your agent:
- Method: POST
- URL:
https://abc123.ngrok.io/lindy/callback - Headers:
Content-Type: application/json - Body (AI Prompt mode):
Send the task result as JSON with fields: taskId, result, status
Or configure a webhook trigger pointing to your tunnel URL:
https://abc123.ngrok.io/lindy/webhook
Step 4: Create Test Harness
// test-trigger.ts — Fire a test webhook to your Lindy agent
import fetch from 'node-fetch';
async function triggerAgent() {
const WEBHOOK_URL = process.env.LINDY_WEBHOOK_URL!;
const SECRET = process.env.LINDY_WEBHOOK_SECRET!;
const response = await fetch(WEBHOOK_URL, {
method: 'POST',
headers: {
'Authorization': `Bearer ${SECRET}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
action: 'test',
data: { message: 'Hello from local dev', timestamp: new Date().toISOString() },
}),
});
console.log(`Status: ${response.status}`);
console.log(`Response: ${await response.text()}`);
}
triggerAgent();
Step 5: Watch Mode Development
// package.json scripts
{
"scripts": {
"dev": "tsx watch server.ts",
"test:trigger": "tsx test-trigger.ts",
"tunnel": "ngrok http 3000"
}
}
# Terminal 1: Start server with auto-reload
npm run dev
# Terminal 2: Start tunnel
npm run tunnel
# Terminal 3: Fire test triggers
npm run test:trigger
Step 6: Environment Configuration
# .env
LINDY_API_KEY=lnd_live_xxxxxxxxxxxx
LINDY_WEBHOOK_SECRET=whsec_xxxxxxxxxxxx
LINDY_WEBHOOK_URL=https://public.lindy.ai/api/v1/webhooks/YOUR_ID
NODE_ENV=development
Development Workflow
[Edit local code] → [Auto-reload via tsx watch]
↓
[Fire test webhook] → [Lindy agent processes]
↓
[Agent calls back] → [ngrok tunnel → localhost:3000]
↓
[Review logs] → [Iterate]
Error Handling
| Issue | Cause | Solution |
|---|---|---|
| ngrok tunnel expires | Free tier limit (2hr) | Restart ngrok or use paid plan |
| Lindy can't reach endpoint | Tunnel URL changed | Update webhook URL in Lindy dashboard |
| Callback not received | Agent HTTP Request misconfigured | Check URL and headers in action config |
ECONNREFUSED |
Local server not running | Start server before testing |
| SSL error | ngrok not using HTTPS | Always use the https:// ngrok URL |
Resources
Next Steps
Proceed to lindy-sdk-patterns for integration patterns and best practices.
04 同仓库更多 Skills
zustand-store-creator
Create zustand store creator operations. Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like "zustand store creator", "zustand creator", "zustand".
zero-trust-config-helper
Configure with zero trust config helper operations. Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like "zero trust config helper", "zero helper", "zero".
zapier-integration-helper
Assist with zapier integration helper operations. Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like "zapier integration helper", "zapier helper", "zapier".
yaml-config-validator
Validate yaml config validator operations. Auto-activating skill for DevOps Basics. Triggers on: yaml config validator, yaml config validator Part of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like "yaml config validator", "yaml validator", "yaml".
xvary-stock-research
Thesis-driven equity analysis from public SEC EDGAR and market data; /analyze, /score, /compare workflows with bundled Python tools (Claude Code, Cursor, Codex).
xss-vulnerability-scanner
Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals. Triggers on: xss vulnerability scanner, xss vulnerability scanner Part of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like "xss vulnerability scanner", "xss scanner", "xss".