lindy-upgrade-migration

Guide for upgrading Lindy SDK and migrating between versions.Use when upgrading SDK versions, migrating agents,or handling breaking changes.Trigger with phrases like "upgrade lindy", "lindy migration","lindy breaking changes", "update lindy SDK".

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

When & Why to Use This Skill

This Claude skill provides a comprehensive guide and automated assistance for upgrading the Lindy SDK and migrating agents between versions. It helps developers identify current versions, navigate breaking changes (such as v1 to v2 transitions), update dependencies, and refactor code patterns to ensure a seamless upgrade process with minimal downtime and high reliability.

Use Cases

  • Upgrading Lindy SDK versions: Safely transition to the latest SDK release by following a structured migration path and checklist.
  • Handling Breaking Changes: Automatically identify and resolve API signature changes, such as client initialization and agent execution method updates between major versions.
  • Dependency Management: Use integrated bash tools to check installed versions, view changelogs, and install specific SDK versions via npm directly within the chat.
  • Code Refactoring & Testing: Access migration scripts and test templates to validate that updated code functions correctly and maintain system stability after an update.
namelindy-upgrade-migration
description|
allowed-toolsRead, Write, Edit, Bash(npm:*)
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Lindy Upgrade & Migration

Overview

Guide for safely upgrading Lindy SDK versions and migrating configurations.

Prerequisites

  • Current SDK version identified
  • Changelog reviewed for target version
  • Backup of current configuration
  • Test environment available

Instructions

Step 1: Check Current Version

# Check installed version
npm list @lindy-ai/sdk

# Check latest available
npm view @lindy-ai/sdk version

# View changelog
npm view @lindy-ai/sdk changelog

Step 2: Review Breaking Changes

// Common breaking changes by version

// v1.x -> v2.x
// - Client initialization changed
// Before: new Lindy(apiKey)
// After:  new Lindy({ apiKey })

// - Agent.run() signature changed
// Before: agent.run(input)
// After:  lindy.agents.run(agentId, { input })

// - Events renamed
// Before: 'complete'
// After:  'completed'

Step 3: Update Dependencies

# Update to latest
npm install @lindy-ai/sdk@latest

# Or specific version
npm install @lindy-ai/sdk@2.0.0

# Check for peer dependency warnings
npm ls @lindy-ai/sdk

Step 4: Update Code

// Migration script for v1 -> v2

// Old code (v1)
import Lindy from '@lindy-ai/sdk';
const client = new Lindy(process.env.LINDY_API_KEY);
const result = await client.runAgent('agt_123', 'Hello');

// New code (v2)
import { Lindy } from '@lindy-ai/sdk';
const client = new Lindy({ apiKey: process.env.LINDY_API_KEY });
const result = await client.agents.run('agt_123', { input: 'Hello' });

Step 5: Run Migration Tests

// tests/migration.test.ts
import { Lindy } from '@lindy-ai/sdk';

describe('SDK Migration', () => {
  const lindy = new Lindy({ apiKey: process.env.LINDY_API_KEY });

  test('client initialization works', async () => {
    const user = await lindy.users.me();
    expect(user.email).toBeDefined();
  });

  test('agent operations work', async () => {
    const agents = await lindy.agents.list();
    expect(Array.isArray(agents)).toBe(true);
  });

  test('run operations work', async () => {
    const result = await lindy.agents.run('agt_test', {
      input: 'Test migration',
    });
    expect(result.output).toBeDefined();
  });
});

Migration Checklist

[ ] Backup current configuration
[ ] Review changelog for breaking changes
[ ] Update package.json
[ ] Run npm install
[ ] Update import statements
[ ] Update client initialization
[ ] Update method calls
[ ] Run test suite
[ ] Test in staging environment
[ ] Deploy to production
[ ] Monitor for issues

Output

  • Updated SDK to target version
  • Migrated code patterns
  • Passing test suite
  • Documented changes

Error Handling

Issue Cause Solution
Import error Named exports changed Check new import syntax
Type error Interface changed Update TypeScript types
Runtime error Method signature changed Check new API

Examples

Automated Migration Script

#!/bin/bash
# migrate-lindy.sh

echo "Starting Lindy SDK migration..."

# Backup
cp package.json package.json.backup
cp -r src src.backup

# Update
npm install @lindy-ai/sdk@latest

# Run tests
npm test

if [ $? -eq 0 ]; then
  echo "Migration successful!"
  rm -rf src.backup package.json.backup
else
  echo "Migration failed. Rolling back..."
  mv package.json.backup package.json
  rm -rf src && mv src.backup src
  npm install
  exit 1
fi

Resources

Next Steps

Proceed to Pro tier skills for advanced features.