Vibeleaderboard
Index / tool

Terminal-Bench

tbench.ai
Visit tbench.ai
Category
AI Agents
Rank
No. 1047Tools index

Previous survey · No. 1006 ·

Pricing
Open Source
Type
TOOL
Use case
Model & Agent Evaluation
Interfaces
CLI · SDK
GitHub
931 stars
Latest release
v4.0.0
Date

About

Terminal-Bench is a benchmark suite for evaluating how well AI agents can perform real-world tasks in terminal environments, from building a Linux kernel to configuring git servers and cracking archive hashes. It provides standardized, harbor-native challenges and a public leaderboard to quantify agent terminal mastery.

What it does

A set of hard, self-contained jobs an AI agent must finish at a command line, each scored by an automated checker. Every task ships with a written instruction, a container that sets up the environment, a reference solution, and tests. You run the whole set through Harbor, the team's evaluation tool, pointing it at an agent and a model, usually on a cloud sandbox like Modal. Tasks span science, software, machine learning, business operations, security, hardware and media, and newer ones can use a GPU or several cooperating containers. Results feed a public leaderboard hosted on Harbor Hub.

Why it's ranked here

The rigor sits in the process around each task, not just the task list. Every proposed task gets an automated review against a 30-point rubric, adversarial runs where agents try to cheat the tests, and a human sign-off from one of two named maintainers. Leaderboard entries must cover every task with at least five trials each, count errored runs as failures, and pass an AI judge that flags reward hacking. The code is Apache 2.0, ships a citation file with a DOI, and the task authors include outside labs and individual researchers named in the repository.

What's good

The checker runs in its own container, separate from the agent, so an agent cannot quietly edit the tests that score it. Each task embeds a canary string so it can be filtered out of training data. Contributors are told to make tasks hard for real reasons, not by adding busywork or cutting network access. Leaderboard trials are copied into storage the maintainers control, so a submitted result cannot later be changed or deleted. Reports show accuracy with a 95% confidence interval plus total tokens and cost.

Tradeoffs

This is not a laptop benchmark. The guide recommends Modal or Daytona because some tasks need an H100 GPU or multiple containers, and the sample oracle check runs 500 jobs at once. The task set changes over time, so scores are only comparable within one pinned dataset version. Tasks run with open internet access, which keeps agents realistic but adds outside variability. The submission guide states community submissions are closed for the current version, with only maintainer runs added. The submission tooling requires Python 3.14 or newer.

How to use it well

Use it if you build or pick coding and operations agents and want a hard, cheat-resistant signal on long, multi-step terminal work. First run the reference solutions five times on your own sandbox to confirm every task passes before you trust agent numbers. Then run your agent and model at the default timeouts so results line up with the public board. If you have domain expertise, contributing a task is the main way in. It does not measure chat quality, short code completion, or anything that cannot be checked by a program.

Technical notes+

Tasks follow the Harbor task format scaffolded from docs/task-template.toml: an instruction, a Dockerfile environment, a solution script, and a test script, with [verifier] environment_mode = "separate", network_mode = "public" and gpus capped at 1 (H100). docs/TAXONOMY.yaml fixes seven categories (Science, Software, ML, Operations, Security, Hardware, Media) with per-subarea senior reviewers. tasks/dataset.toml pins each published task by sha256 digest. docs/REVIEWING.md lists static CI checks (canary present, Dockerfile must not copy solution or tests, absolute paths in instructions) plus /run, /cheat, /regrade and /fortify comment commands. leaderboard/src/leaderboard/cli.py is a Typer app exposing filter, metadata, open-prs and submit; leaderboard/pyproject.toml pins harbor[modal]>=0.20.0 and supabase. archive/build-pmars/task.toml shows an older schema with difficulty and time estimates.

Observed

License
Apache License 2.0
Runner
Harbor CLI, installed with uv tool install harbor
Recommended execution environments
Modal or Daytona cloud sandboxes; Docker for local task development
Task structure
Instruction, Docker environment, reference solution and test script per task, verifier in a separate container
Leaderboard tooling
Python CLI named lb, requires Python 3.14 or newer
Submission rule
Every task covered with at least five trials; errored trials scored as zero
Citation
CITATION.cff with Zenodo DOI

Read from README.md, CONTRIBUTING.md, LICENSE, CITATION.cff, docs/REVIEWING.md, docs/TAXONOMY.yaml, docs/task-template.toml, tasks/README.md, tasks/dataset.toml, leaderboard/SUBMIT.md, leaderboard/pyproject.toml, leaderboard/src/leaderboard/cli.py, archive/build-pmars/instruction.md, archive/build-pmars/task.toml, .github/workflows/validate-task.yml.

What it can do

  • Evaluate an AI agent's ability to complete terminal-based tasks

    An AI agent configured to run against the benchmark suite → Performance scores measuring task completion success

  • Run standardized real-world terminal challenges (e.g., building a Linux kernel, configuring git servers, cracking archive hashes)

    A selected benchmark task and target agent → Task execution results and pass/fail outcomes

  • Provide harbor-native challenge environments for testing

    A benchmark version selection (e.g., v2.1) → Reproducible standardized terminal environments

  • Rank agents on a public leaderboard

    Agent benchmark evaluation results → Leaderboard ranking of agent terminal mastery

  • Quantify agent capability on long-running single-task challenges

    Agent run data across multiple challenge tasks → Aggregated metrics comparing agents

Intel on Terminal-Bench

More in Intel

Tags

ai-agentsbenchmarkterminalevaluationllmleaderboardcli

Media

Terminal-Bench

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.