← All extensions

Agnix

v0.61.0 · by Avi Fenesh · added 6 November 2026

Linter for agent configurations (skills, hooks, memory, plugins, MCP)

Language servers
Install in Forge SuperView the source

How to install

With Forge Super installed, the button above opens the app on this extension, where you press Install. Nothing is installed until you do.

You can also open the Extensions panel in the app and search for Agnix. The extension's id is agnix.

Don't have Forge Super yet? Download it here.

README

From the extension's repository, written by its authors and not by Mentenaz. See the source.

agnix for Zed

Zed extension for agnix - lint agent configurations before they break your workflow.

Provides real-time validation of AI agent configuration files (CLAUDE.md, AGENTS.md, SKILL.md, .claude/settings.json, *.mcp.json, .cursor/rules/*.mdc, and more) using the agnix-lsp language server.

Features

  • Automatic LSP binary download from GitHub releases
  • Real-time diagnostics as you type
  • Quick-fix code actions for auto-fixable issues
  • Hover documentation for configuration fields
  • 757 validation rules across 46 categories

Requirements

The extension automatically downloads the agnix-lsp binary - no manual installation needed.

Installation

  1. Open Zed
  2. Open the Extensions panel (Zed > Extensions, or cmd+shift+x)
  3. Search for "agnix"
  4. Click Install

Configuration

agnix reads configuration from .agnix.toml in your project root. See the Configuration Reference for all options.

Example .agnix.toml:

tools = ["claude-code"]
severity = "Warning"

[rules]
disabled_rules = ["AS-001"]

Supported File Types

File PatternType
SKILL.mdAgent skill definitions
CLAUDE.md, CLAUDE.local.mdClaude Code memory
AGENTS.md, AGENTS.local.md, AGENTS.override.mdAgent memory
.claude/settings.json, .claude/settings.local.jsonHook configurations
plugin.jsonPlugin manifests
*.mcp.json, mcp.json, mcp-*.jsonMCP tool configurations
.github/copilot-instructions.mdCopilot instructions
.github/instructions/*.instructions.mdCopilot scoped instructions
.cursor/rules/*.mdcCursor project rules
.cursorrulesLegacy Cursor rules
.claude/agents/*.mdClaude agent definitions

Troubleshooting

No diagnostics appearing

  1. Verify the file is a supported type (see table above)
  2. Check the Zed log (cmd+shift+p > "zed: open log") for LSP errors
  3. Ensure the project has a .git directory or .agnix.toml for root detection

LSP binary download fails

The extension downloads the agnix-lsp binary from GitHub releases. If the download fails:

  1. Check your internet connection
  2. Verify you can access https://github.com/agent-sh/agnix/releases
  3. Try restarting Zed to trigger a fresh download

Manual LSP binary

The extension does not use an agnix-lsp on your PATH. It runs the copy it downloads and checks GitHub releases each time Zed starts, so Zed needs network access to start the server.

License

MIT - see LICENSE