gitwtfhub

wtf is agent-bench?

dabit3/agent-bench — explained in plain English

Analysis updated 2026-08-09 · repo last pushed 2026-02-21

8TypeScriptAudience · pm founderComplexity · 2/5MaintainedSetup · easy

TL;DR

A command-line tool that runs standardized tests against AI agents and models, then reports pass/fail rates, token usage, cost, and speed so teams can compare options objectively.

Mindmap

mindmap
  root((repo))
    What it does
      Runs AI agent tests
      Compares models
      Reports cost and speed
    Built-in tasks
      Reasoning
      Coding
      Data parsing
      Tool use and research
    Tech stack
      TypeScript
      YAML configs
      LLM adapters
    Use cases
      Model selection
      Catch prompt regressions
      CI CD quality gates
    Audience
      AI product teams
      Startups comparing models

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Compare two AI models side by side on cost, accuracy, and speed before deciding which to use in your product.

REASON 2

Run a benchmark before and after changing your agent's system prompt to catch regressions.

REASON 3

Add a quality gate to CI/CD that blocks pull requests when the agent's success rate drops below a threshold.

REASON 4

Write custom test suites in YAML with your own prompts and pass/fail validation rules.

What's in the stack?

TypeScriptYAML

How it stacks up

dabit3/agent-benchabdulkader-safi/obsidian-image-magick-pluginsacartag7/mcp-sso
Stars888
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-02-21
MaintenanceMaintained
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencepm foundergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

You need API keys for whichever LLM providers you want to benchmark, but the tool itself installs with minimal dependencies.

No license information was provided in the explanation, so usage rights are unknown.

Wtf does this do

Agent-bench is a tool for putting AI agents through a standardized test suite so you can compare them on what actually matters: did they get the right answer, how much did it cost, and how long did it take? Instead of running ad-hoc prompts and eyeballing results, you run a command and get a clear report showing pass/fail rates, token usage, total cost in dollars, and average response time. The tool ships with 17 built-in tasks across five categories: reasoning (math, logic puzzles), coding (code generation, debugging), data (JSON and CSV parsing), tool-use (function calling), and research (synthesis and explanation). You pick a suite, point it at a model like GPT-4o or Claude, and it runs the tasks, checks the answers, and produces a report. You can save results to a file and then run a compare command across multiple models to see them side by side. You can also write your own custom test suites in a simple YAML file, defining your own prompts and validation rules for what counts as a correct answer. This is for teams building AI-powered products who need to make decisions like "should we switch from GPT-4o to Claude" or "did our latest prompt change break something." A startup deciding between models can run the same suite against both and see a concrete cost-and-accuracy comparison. A team that just updated their agent's system prompt can run benchmarks before and after to catch regressions. It also integrates into CI/CD pipelines, so you can automatically block a pull request if the success rate drops below a threshold. One notable design choice is that it works with any LLM provider through an adapter pattern, meaning you aren't locked into OpenAI or Anthropic. You can even write a custom adapter for your own agent. The project also emphasizes being lightweight with minimal dependencies, which keeps installation and runs fast.

Yoink these prompts

Prompt 1
Using agent-bench, set up a benchmark suite that tests GPT-4o and Claude on coding and reasoning tasks, then run the compare command to show cost and accuracy side by side.
Prompt 2
Create a custom YAML test suite for agent-bench with five prompt-and-validation pairs that check whether an AI agent can correctly parse JSON and return a specific field.
Prompt 3
Show me how to integrate agent-bench into a GitHub Actions workflow so a pull request is blocked if the agent benchmark success rate falls below 80%.
Prompt 4
Write a custom LLM adapter for agent-bench that connects to a self-hosted model endpoint instead of OpenAI or Anthropic.

Frequently asked questions

wtf is agent-bench?

A command-line tool that runs standardized tests against AI agents and models, then reports pass/fail rates, token usage, cost, and speed so teams can compare options objectively.

What language is agent-bench written in?

Mainly TypeScript. The stack also includes TypeScript, YAML.

Is agent-bench actively maintained?

Maintained — commit in last 6 months (last push 2026-02-21).

What license does agent-bench use?

No license information was provided in the explanation, so usage rights are unknown.

How hard is agent-bench to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agent-bench for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.