Agent Friendly Code

zigtools/zls

GitHub
https://github.com/zigtools/zls

A language server for Zig supporting developers with features like autocomplete and goto definition

  • language-server
  • lsp
  • lsp-server
  • zig
  • zls
Stars:
5.2k
Language:
Zig
Default branch:
master
Last scored:
Overall

At a glance

Rank
#284 of 401
#4 of 6 Zig repos
Checks passed
7 of 16
Full list below
Best set up for
Devin
Score 68.8
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    AGENTS.md / CLAUDE.md
    Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
    +13.2 pts
  2. 2
    Linter / formatter config
    Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
    +7.9 pts
  3. 3
    CONTRIBUTING guide
    Add CONTRIBUTING.md describing branch naming, commit style, test commands, and the PR process.
    +5.3 pts

Score for each AI agent

Each agent looks for different things in a repo, based on its own docs. Under each score are the three checks it cares about most; the agent's name links to its leaderboard. How each agent is scored →

Devin
#266 of 401
68.8
  • Reproducible dev env
  • Dependency manifest
  • Test suite
GPT-5 Codex
#286 of 401
66.5
  • AGENTS.md / CLAUDE.md
  • README
  • Test suite
Claude Code
#282 of 401
64.9
  • AGENTS.md / CLAUDE.md
  • Test suite
  • Reproducible dev env
Kimi CLI
#292 of 401
63.2
  • AGENTS.md / CLAUDE.md
  • Test suite
  • Dependency manifest
Pi
#299 of 401
62.3
  • AGENTS.md / CLAUDE.md
  • Test suite
  • Linter / formatter config
OpenHands
#272 of 401
61.5
  • CI configuration
  • Dependency manifest
  • Reproducible dev env
Gemini CLI
#263 of 401
61.2
  • GEMINI.md
  • README
  • Test suite
Cursor
#286 of 401
59.6
  • Cursor rules (.cursor/rules)
  • README
  • Type configuration
Aider
#283 of 401
57.0
  • .aider.conf.yml
  • Linter / formatter config
  • Test suite

Does zigtools/zls have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md
None at the root (no AGENTS.md, CLAUDE.md or AGENT.md)
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh or .aider.conf.yml
Repos that have one
3 of 6 Zig repos · 214 of 401 repos on the leaderboard · See examples →

All 16 checks · 7 passed

AGENTS.md / CLAUDE.md· 0% pass
No agent instructions file found
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
3 GitHub Actions workflows
.github/workflows
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 100% pass
Manifest present
build.zig
Reproducible dev env· 70% pass
Has flake.nix
flake.nix
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 0% pass
No linter/formatter config found
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (2,337 characters)
README.md
Manageable size· 100% pass
101 files
Test suite· 100% pass
Found /tests
tests
Type configuration· 100% pass
Typed language (Zig)

How zigtools/zls compares

vs leaderboard average
6.1 pts below
Average 68.9
vs Zig average
0.8 pts above
Average 62.0
Stars among Zig repos
#6 of 6

Missing here, and how many repos have it

  • CONTRIBUTING guide · passed by 86% of leaderboard repos, 50% of Zig repos
  • Linter / formatter config · passed by 66% of leaderboard repos, 17% of Zig repos
  • Pre-commit / git hooks · passed by 29% of leaderboard repos, 0% of Zig repos

Passes checks most repos miss

  • Manageable size · only 17% of repos pass it

One fix for the most agents: AGENTS.md / CLAUDE.md would raise the score for all 9 agents, by up to 14.1 points.

Similar repos

Same language and host first, then the repos closest in overall score.

All Zig repos →

Add a badge to your README

Paste this at the top of the README. It shows the score, and links back to this page.

Agent friendly score for github/zigtools/zls
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/zigtools/zls.svg)](https://agentfriendlycode.com/repo/github/zigtools/zls)

Check the score on every pull request

A GitHub Action posts one comment per pull request with how the score changed and why.