---

name: lindy-local-dev-loop description: | Set up local development workflow for Lindy AI agents. Use when configuring local testing, hot reload, or development environment. Trigger with phrases like "lindy local dev", "lindy development", "lindy hot reload", "test lindy locally". allowed-tools: Read, Write, Edit, Bash(npm:), Bash(node:) version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io

Lindy Local Dev Loop

Overview

Configure efficient local development workflow for Lindy AI agent development.

Prerequisites

• Completed lindy-install-auth setup
• Node.js 18+ with npm/pnpm
• Code editor with TypeScript support

Instructions

Step 1: Set Up Project Structure

Copymkdir lindy-agents && cd lindy-agents
npm init -y
npm install @lindy-ai/sdk typescript ts-node dotenv
npm install -D @types/node nodemon

Step 2: Configure TypeScript

Copy// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true
  },
  "include": ["src/**/*"]
}

Step 3: Create Development Script

Copy// package.json scripts
{
  "scripts": {
    "dev": "nodemon --exec ts-node src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js",
    "test:agent": "ts-node src/test-agent.ts"
  }
}

Step 4: Create Agent Test Harness

Copy// src/test-agent.ts
import 'dotenv/config';
import { Lindy } from '@lindy-ai/sdk';

const lindy = new Lindy({ apiKey: process.env.LINDY_API_KEY });

async function testAgent(agentId: string, input: string) {
  console.log(`Testing agent ${agentId} with: "${input}"`);
  const start = Date.now();

  const result = await lindy.agents.run(agentId, { input });

  console.log(`Response (${Date.now() - start}ms): ${result.output}`);
  return result;
}

// Run test
testAgent(process.argv[2], process.argv[3] || 'Hello!');

Output

• Configured development environment
• Hot reload enabled for agent code
• Test harness for rapid iteration
• TypeScript support with type checking

Error Handling

Examples

Watch Mode Development

Copy# Start development with hot reload
npm run dev

# Test specific agent
npm run test:agent agt_abc123 "Test input"

Environment Setup

Copy# .env file
LINDY_API_KEY=your-api-key
LINDY_ENVIRONMENT=development

Resources

• Lindy SDK Reference
• TypeScript Best Practices

Next Steps

Proceed to lindy-sdk-patterns for SDK best practices.