lindy-local-dev-loop

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".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Lindy Local Dev Loop skill streamlines the creation of Lindy AI agents by automating the setup of a professional local development environment. It enhances developer productivity by configuring TypeScript, enabling hot reload capabilities, and establishing a dedicated test harness for rapid iteration and debugging.

Use Cases

  • Initializing a standardized local workspace for Lindy AI agent development with all required Node.js dependencies.
  • Setting up a 'hot reload' workflow using nodemon to automatically restart and test agents upon code changes.
  • Creating a TypeScript-based test harness to validate agent logic and API responses locally before deployment.
  • Configuring environment variables and SDK authentication to ensure secure and consistent local testing environments.
namelindy-local-dev-loop
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(node:*)
version1.0.0
licenseMIT
authorJeremy 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

mkdir 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

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

Step 3: Create Development Script

// 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

// 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

Error Cause Solution
ts-node not found Dev deps missing npm install -D ts-node
ENV not loaded dotenv not configured Add import 'dotenv/config'
Type errors Missing types npm install -D @types/node

Examples

Watch Mode Development

# Start development with hot reload
npm run dev

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

Environment Setup

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

Resources

Next Steps

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