Agent Lint
VS Code extension that validates AGENTS.md presence and configuration in your project.
AGENTS.md is an open format for AI coding agent instructions. This extension helps ensure your project is properly set up so agents like Cursor, Copilot, Codex, and others can find and use your project context.
Features
- Detects
AGENTS.md at workspace root and in nested monorepo packages
- Flags deprecated
AGENT.md (singular) with migration guidance
- Validates Markdown structure, recommended sections, and actionable commands
- Shows diagnostics in the Problems panel with severity levels
- Status bar indicator (green / yellow / red)
- Quick fixes: scaffold
AGENTS.md template, rename AGENT.md → AGENTS.md
- Watches for file changes and re-validates on save
Installation
From VS Code Marketplace
Search for Agent Lint by chereshnyuk, or install from:
marketplace.visualstudio.com/items?itemName=chereshnyuk.agent-lint
From source
git clone https://github.com/chereshnyuk/vscode-extension-agent-lint.git
cd vscode-extension-agent-lint
npm install
npm run compile
Press F5 in VS Code to launch Extension Development Host.
From VSIX
npm run package
code --install-extension agent-lint-0.1.0.vsix
Usage
Open any workspace. The extension activates automatically and scans for AGENTS.md files.
- Check the status bar for a quick health summary
- Open Problems panel for detailed diagnostics
- Use quick fixes (lightbulb) on
AGENTS.md / AGENT.md files
- Run command palette: Agent Lint: Create AGENTS.md with template
Settings
| Setting |
Default |
Description |
agentLint.strictMode |
false |
Escalate missing recommended sections to warnings |
agentLint.scanDepth |
5 |
Max directory depth for nested AGENTS.md discovery |
agentLint.exclude |
["**/node_modules/**", "**/.git/**"] |
Glob patterns to exclude from scanning |
Validation Rules
| Rule |
Severity |
Description |
agents-md/missing-root |
Error |
No AGENTS.md at workspace root |
agents-md/deprecated-alias |
Warning |
AGENT.md without sibling AGENTS.md |
agents-md/empty-file |
Error |
File is empty |
agents-md/no-headings |
Warning |
No Markdown headings |
agents-md/missing-section-* |
Info |
Missing recommended section |
agents-md/no-commands |
Warning |
No fenced code blocks or inline commands |
agents-md/oversized |
Warning |
File exceeds 50 KB |
Development
npm install
npm run watch # compile on change
npm test # run unit + integration tests
npm run lint # ESLint
npm run package # build .vsix
Learn More
License
MIT
