Bun DocsReferenceBun version feature matrix
Bun version feature matrix
The Bun version that introduced each commonly used capability, for upgrade decisions and agent task routing
Last updated on
When to check this page
- Before using a flag or API from these docs, confirm
bun --versionmeets the minimum. - When briefing an agent, state the pinned version so it never generates usage your Bun cannot run.
- Before upgrading, read the official release notes for each version — not just this table.
Matrix
| Capability | First available | Related page |
|---|---|---|
Declarative routes in Bun.serve | 1.2.0 | Runtime |
Bun.sql (PostgreSQL client) | 1.2.0 | Data and storage |
Text lockfile bun.lock becomes the default format | 1.2.0 | Package manager |
Dependency lifecycle scripts blocked by default + bun pm trust / bun pm untrusted | 1.2.0 | Package manager |
Isolated linker (linker = "isolated", default for workspaces) | 1.3.0 | Monorepo and workspaces |
Workspace catalogs (catalog: protocol) | 1.2.14 | Monorepo and workspaces |
bun audit | 1.2.15 | Package manager |
bun audit --prod / --audit-level / --ignore | 1.2.21 | Production baseline |
| Bun.SQL unified client adds MySQL / MariaDB and SQLite | 1.2.x (mid-2025) | Data and storage |
RedisClient (built-in Redis client) | 1.2.x (2025) | Data and storage |
RedisClient Pub/Sub | 1.2.23 | Data and storage |
minimumReleaseAge (minimum publish age) | 1.3.0 | Package manager |
AGENT=1 / CLAUDECODE=1 compact test output | 1.2.x | Test runner |
bun test --isolate / --parallel | 1.3.13 | Test runner |
Exact minor versions: trust primary sources
Rows marked 1.2.x were introduced during the 1.2 cycle, but this page's review did not pin the exact minor. Before writing a version into CI constraints or a migration plan, confirm it against the Bun blog and release notes. If this table ever conflicts with a primary source, the primary source wins — please report it to the site maintainer.
Conventions
- Versions refer to stable releases; canary builds are out of scope.
- "First available" is not "production-ready": validate new capabilities under the production baseline.
- The table only covers capabilities that affect task routing or migration decisions; it is not a full changelog.
Agent usage
Two lines in the task constraints eliminate a whole class of hallucinations:
Environment: Bun 1.3.14 (pinned). Do not use features newer than this version.
If a capability requires a newer Bun, stop and report instead of guessing.