Release History of Freebuff: Complete Version Timeline from v0.1.0 to v2.1.x

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 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 at the repository root. The current version is reflected in package.json (e.g., "version": "2.1.0" as of the latest commit).

Official releases are published on the GitHub 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 with current version data stored in 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 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 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 at the root of the repository (e.g., "version": "2.1.0"). This value is synchronized with Git tags and the CHANGELOG.md headers during the release workflow.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}