Skip to content

lantern lint

lantern lint is AgentLantern's static checker for agent projects.

It catches design issues before runtime: missing agents, invalid task references, incomplete YAML fields, suspicious delegation settings, wrong field types, and other project structure problems.

It does not call an LLM and does not require network access.

Pages

PageUse it for
Run the LinterBasic commands, strict mode, JSON mode
CrewAI RulesError, warning, and info rule reference
JSON and CIMachine-readable output, exit codes, GitHub Actions, pre-commit
TroubleshootingCommon linter problems

How It Works

The linter reads the same project model that lantern docs uses:

  • YAML config files,
  • Python AST,
  • framework-specific analyzer output.

Then it applies rules specific to the detected framework.

Current Coverage

FrameworkLinter status
CrewAIFull rule set
Google ADKFramework rules
LangGraphGraph rules
AutoGenCommon Python-agent rules
SmolagentsCommon Python-agent rules
OpenAI Agents SDKCommon Python-agent rules
Additional Python ecosystemsCommon Python-agent rules
JavaScript/TypeScript ecosystemsCommon JS-agent rules
Semantic Kernel .NET/JavaSemantic Kernel rules
Other Python or JS/TS frameworksCommon agent rules

Released under the MIT License.