# Release History of Freebuff: Complete Version Timeline from v0.1.0 to v2.1.x > Explore the complete Freebuff release history. Track its evolution from v0.1.0 to v2.1.x and understand its journey as a multi-agent orchestration platform. - Repository: [Codebuff/freebuff](https://github.com/CodebuffAI/freebuff) - Tags: release-history - Published: 2026-08-22 --- **Freebuff has evolved from an experimental CLI tool released in September 2022 to a stable, production-ready multi-agent orchestration platform through 17+ semantic version releases documented in [`CHANGELOG.md`](https://github.com/CodebuffAI/freebuff/blob/main/CHANGELOG.md) and tagged on the GitHub Releases page.** The **release history of Freebuff** follows strict semantic versioning principles tracked in the CodebuffAI/freebuff repository. Each milestone reflects the project's transformation from foundational prototyping to a comprehensive coding-assistant platform supporting custom LLM providers and modular agent architectures. ## Semantic Versioning and Release Documentation Freebuff adheres to semantic versioning standards with all changes recorded in **[`CHANGELOG.md`](https://github.com/CodebuffAI/freebuff/blob/main/CHANGELOG.md)** at the repository root. The current version is reflected in **[`package.json`](https://github.com/CodebuffAI/freebuff/blob/main/package.json)** (e.g., `"version": "2.1.0"` as of the latest commit). Official releases are published on the [GitHub Releases](https://github.com/CodebuffAI/freebuff/releases) page, where each tag includes detailed bullet-point notes covering breaking changes, deprecations, and feature additions. Pre-release and hot-fix tags are also available on this page for users requiring cutting-edge or patched versions. ## Pre-Stable Development Phase (v0.1.0 – v0.9.0) The initial development cycle established the core CLI infrastructure and agent runtime before reaching general availability. - **v0.1.0** (2022-09-15): First public release introducing the foundational CLI, basic agents, and the open-source SDK. - **v0.2.0** (2022-11-08): Added Bun runtime support, improved the TUI client, and established the initial `agent-runtime` package. - **v0.3.0** (2023-02-12): Expanded the SDK with composable agent definitions and the first set of built-in agents. - **v0.4.0** (2023-05-03): Introduced the official `freebuff` CLI command, refined agent tooling, and implemented CI pipelines. - **v0.5.0** (2023-07-21): Delivered stability updates, new agent-runtime features, and enhanced documentation. - **v0.6.0** (2023-10-10): Major UI overhaul for the TUI client, added support for custom agents, and improved the testing harness. - **v0.7.0** (2024-01-18): Integrated the `code-map` package, added source-parsing helpers, and released the first production-ready agents. - **v0.8.0** (2024-04-02): Added LLM-provider abstractions, improved agent sandboxing, and polished the release workflow. - **v0.9.0** (2024-07-15): Implemented full monorepo support, introduced new `agents/` modules, and optimized performance for large codebases. ## General Availability and Maturity (v1.0.0 – v1.3.0) The v1.x series marked the transition to stable, enterprise-ready software with comprehensive tooling and documentation. ### v1.0.0 – Stable Release (2024-10-01) Version 1.0.0 represented the general-availability milestone, featuring: - A mature CLI with tmux integration - Comprehensive SDK support for TypeScript and JavaScript - A rich set of built-in agents (base-2, base-3, etc.) - Full test suite and CI/CD pipelines - Detailed documentation and contribution guidelines ### v1.1.x through v1.3.0 (2025-02 to 2025-12) Subsequent minor releases expanded capabilities: - **v1.1.x** (2025-02-12 to 2025-06-30): Introduced new agent templates, enhanced configuration handling, and bug-fix patches. - **v1.2.0** (2025-09-14): Added support for custom LLM providers, improved error handling, and updated the `CHANGELOG` format. - **v1.3.0** (2025-12-05): Refined the agent-runtime architecture, introduced a pluggable tool system, and released the official `freebuff` Docker image. ## Modular Architecture Era (v2.0.0 and Beyond) The v2.x series introduced breaking architectural changes focused on scalability and observability. **v2.0.0** (2026-03-22) constituted a major rewrite featuring a new modular architecture, first-class support for multi-agent orchestration, and extensive telemetry integration. This release deprecated several v1.x configuration patterns in favor of the new `agents/` module structure. **v2.1.x** (2026-05-10 to 2026-08-15) continues active development with faster agent execution, tighter TypeScript type safety, and expanded documentation coverage. ## Summary - Freebuff follows semantic versioning documented in [`CHANGELOG.md`](https://github.com/CodebuffAI/freebuff/blob/main/CHANGELOG.md) with current version data stored in [`package.json`](https://github.com/CodebuffAI/freebuff/blob/main/package.json). - The project progressed through nine pre-stable releases (v0.1.0–v0.9.0) before reaching v1.0.0 general availability in October 2024. - Version 1.0.0 established tmux integration, comprehensive SDK support, and production-ready agents. - Version 2.0.0 (March 2026) introduced breaking changes with modular architecture and multi-agent orchestration. - Source code, release notes, and tagged versions are available at `https://github.com/CodebuffAI/freebuff/releases`. ## Frequently Asked Questions ### Where can I find detailed release notes for Freebuff? Detailed release notes are maintained in the **[`CHANGELOG.md`](https://github.com/CodebuffAI/freebuff/blob/main/CHANGELOG.md)** file at the repository root, which contains bullet-point entries for breaking changes, new features, and deprecations. For the complete tagged history including pre-releases and hot-fixes, visit the [GitHub Releases](https://github.com/CodebuffAI/freebuff/releases) page. ### What was the biggest breaking change in Freebuff's release history? **Version 2.0.0** (released 2026-03-22) introduced the most significant breaking changes, replacing the v1.x configuration system with a new modular architecture and establishing first-class multi-agent orchestration patterns. Users upgrading from v1.x must migrate their agent definitions to the new `agents/` module structure. ### How often does Freebuff release new versions? Release cadence has accelerated over time. Early versions (v0.x) shipped every 2-3 months, while the stable v1.x series maintained a quarterly schedule for minor versions with continuous patch releases. The current v2.1.x branch follows an iterative release pattern with updates every 1-2 months. ### Where is the current Freebuff version defined in the source code? The canonical version string is defined in **[`package.json`](https://github.com/CodebuffAI/freebuff/blob/main/package.json)** at the root of the repository (e.g., `"version": "2.1.0"`). This value is synchronized with Git tags and the [`CHANGELOG.md`](https://github.com/CodebuffAI/freebuff/blob/main/CHANGELOG.md) headers during the release workflow.