lindy-common-errors
Troubleshoot common Lindy AI errors and issues. Use when encountering errors, debugging agent failures, or resolving integration problems. Trigger with phrases like "lindy error", "lindy not working", "debug lindy", "lindy troubleshoot".
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 2.0k
- Forks
- 233
01 前言 Front Matter
- name
- lindy-common-errors
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Troubleshoot common Lindy AI errors and issues. Use when encountering errors, debugging agent failures, or resolving integration problems. Trigger with phrases like "lindy error", "lindy not working", "debug lindy", "lindy troubleshoot".
- allowed-tools
- Read, Write, Edit, Grep
03 SKILL.md 正文
Lindy Common Errors
Overview
Comprehensive guide to troubleshooting common Lindy AI errors and issues.
Prerequisites
- Lindy SDK installed
- Access to logs and error messages
- Basic debugging skills
Common Errors
Authentication Errors
LINDY_AUTH_INVALID_KEY
Error: Invalid API key provided
Code: LINDY_AUTH_INVALID_KEY
Causes:
- Expired API key
- Incorrect key format
- Key from wrong environment
Solutions:
# Verify key is set
echo $LINDY_API_KEY
# Regenerate key in dashboard
# https://app.lindy.ai/settings/api-keys
# Test key
curl -H "Authorization: Bearer $LINDY_API_KEY" \
https://api.lindy.ai/v1/users/me
Rate Limit Errors
LINDY_RATE_LIMITED
Error: Rate limit exceeded
Code: LINDY_RATE_LIMITED
Retry-After: 60
Causes:
- Too many API requests
- Concurrent agent runs exceeded
- Burst limit reached
Solutions:
// Implement exponential backoff
async function withBackoff<T>(fn: () => Promise<T>): Promise<T> {
for (let i = 0; i < 5; i++) {
try {
return await fn();
} catch (e: any) {
if (e.code === 'LINDY_RATE_LIMITED') {
const delay = Math.pow(2, i) * 1000;
await new Promise(r => setTimeout(r, delay));
continue;
}
throw e;
}
}
throw new Error('Max retries exceeded');
}
Agent Errors
LINDY_AGENT_NOT_FOUND
Error: Agent not found
Code: LINDY_AGENT_NOT_FOUND
Solutions:
// Verify agent exists
const agents = await lindy.agents.list();
const exists = agents.some(a => a.id === agentId);
// Check environment (dev vs prod)
console.log('Environment:', process.env.LINDY_ENVIRONMENT);
LINDY_AGENT_TIMEOUT
Error: Agent execution timed out
Code: LINDY_AGENT_TIMEOUT
Solutions:
// Increase timeout
const result = await lindy.agents.run(agentId, {
input,
timeout: 120000, // 2 minutes
});
// Use streaming for long tasks
const stream = await lindy.agents.runStream(agentId, { input });
Tool Errors
LINDY_TOOL_FAILED
Error: Tool execution failed
Code: LINDY_TOOL_FAILED
Tool: email
Solutions:
// Check tool configuration
const agent = await lindy.agents.get(agentId);
console.log('Tools:', agent.tools);
// Verify tool credentials
await lindy.tools.test('email');
Debugging Checklist
[ ] API key is valid and not expired
[ ] Correct environment (dev/staging/prod)
[ ] Agent ID exists and is accessible
[ ] Rate limits not exceeded
[ ] Network connectivity to api.lindy.ai
[ ] Required tools are configured
[ ] Timeout is sufficient for task
Error Handling
| Error Code | HTTP Status | Retry? |
|---|---|---|
| LINDY_AUTH_INVALID_KEY | 401 | No |
| LINDY_RATE_LIMITED | 429 | Yes |
| LINDY_AGENT_NOT_FOUND | 404 | No |
| LINDY_AGENT_TIMEOUT | 504 | Yes |
| LINDY_TOOL_FAILED | 500 | Maybe |
Resources
Next Steps
Proceed to lindy-debug-bundle for comprehensive debugging.
04 同仓库更多 Skills
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
web-artifacts-builder
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
neuropixels-analysis
Neuropixels neural recording analysis. Load SpikeGLX/OpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen/IBL curation, AI-assisted visual analysis, for Neuropixels 1.0/2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
notebooklm
Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.