Terminal-Bench
tbench.ai- Category
- AI Agents
- Rank
- No. 1047Tools index
Previous survey · No. 1006 ·
- Listed in
- Find AI benchmarks
- Pricing
- Open Source
- Type
- TOOL
- Use case
- Model & Agent Evaluation
- Interfaces
- CLI · SDK
- Builder
- harbor-framework
- 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
- Long-Horizon-Terminal-Bench 2.0: Automating Diverse Task Construction and Measuring Sustained Agent Progress
- Terminal-Bench-Science leaderboard debuts: GPT-6 Astra and Claude Opus 5.5 lead
- StepFun Open-Sources Step Code, a CLI Coding Agent Benchmarked on Terminal-Bench
- Run Terminal-Bench and other Harbor evals on Vercel Sandbox
- Vals AI Launches Terminal-Bench 4.0 With Stricter Pass/Fail Grading
Tags
Media

Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.