NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #36 by repository stars
Latest stable
v1.3.10
Last release 9 months ago
16 Feb 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
592 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This release fixes a small bug where views would render blank if the view’s return value didn’t change after toggling the altscreen.
This release fixes a small bug where views would render blank if the view’s return value didn’t change after toggling the altscreen.
🤗 Special thanks to @chris-miner for flagging this one.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge.jpg?1" width="400"></a>
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Slack.
Nothing published for this version
This release restores support for Dragonfly BSD and fixes a bug where general BSD builds would fail with Go 1.17. BSD users, let us know if you notice
This release restores support for Dragonfly BSD and fixes a bug where general BSD builds would fail with Go 1.17. BSD users, let us know if you notice anything else is awry.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge.jpg?1" width="400"></a>
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This update fixes a regression introduced in v0.16.0 that prevented Bubble Tea from building on BSD systems (excluding Darwin).
This update fixes a regression introduced in v0.16.0 that prevented Bubble Tea from building on BSD systems (excluding Darwin).
Here’s the changelog.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
This release features `Program.StartReturningModel`, a handy alternative start method for returning the final Model after a Program exits. This makes
This release features Program.StartReturningModel, a handy alternative start method for returning the final Model after a Program exits. This makes it easy to access data collected in a Bubble Tea program while still working in an immutable fashion.
Here’s an example illustrating how it works:
type MyModel struct {
Name string
FaveCatColor string
}
p := tea.NewProgram(MyModel{})
// Return the final model when we're done
finalModel, err := p.StartReturningModel()
if err != nil {
fmt.Println("Uh oh", err)
os.Exit(1)
}
// The final model is a generalized tea.Model, so be sure to assert it into
// your actual model type.
if m, ok := finalModel.(MyModel); ok {
fmt.Printf("Hello, %s. I have a %s kitty for you.\n", m.Name, m.FaveCatColor)
}
🤗 A big thanks to @Raphexion for both conceptualizing and executing this feature.
We’ve also made the ANSI compressor opt-in by default as we noticed that it was incurring a larger performance hit than we’d like in some cases. To enable the ANSI compressor just use the WithANSICompressor program option:
tea.NewProgram(model, tea.WithANSICompressor())
Here’s the full changelog for this release.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
The big news in this release is the integration of @muesli’s ANSI compressor from his new ANSI package. The compressor, which has been integrated into
The big news in this release is the integration of @muesli’s ANSI compressor from his new ANSI package. The compressor, which has been integrated into the renderer, automatically removes redundant ANSI sequences and, as such, it can be considered lossless. This should improve rendering speeds both locally and over the wire.
Program.Quit() helper function as acutely suggested by @aymanbagabasWhen quitting a Bubble Tea program from the outside you previously had to…
p.Send(tea.Quit())
…which works, but also feels a little silly. So now you can just…
p.Quit()
Here’s the full changelog.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
This release adds mouse support in Windows! It also fixes a regression introduced in v0.16.0 where the arrow keys didn't work on Windows.
This release adds mouse support in Windows! It also fixes a regression introduced in v0.16.0 where the arrow keys didn't work on Windows.
As a side effect to the above, cancelable reads have been disabled in Windows for now. This means applications running in Windows can not run multiple Programs in succession in the context of a single application, nor can user input be reliably read after a Program has exited until the Go application exits. This is temporary and a solution is in development.
v0.16.0. This will be addressed in a subsequent release.Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
This release implements a cancelable input reader which allows user input to be read after a Program has exited. This means that you can now run multi
This release implements a cancelable input reader which allows user input to be read after a Program has exited. This means that you can now run multiple Programs in succession in a single application as well as generally read user input in other after a Program has exited in the context of a single application.
In addition, all Goroutines are now gracefully terminated before Program.Start() returns, resulting in reliable behavior between subsequent Programs.
This update has been a major undertaking by @erikgeiser, who built specific implementations for Linux, BSD/macOS, and Windows as well as a general purpose implementation for other flavors of unix.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
Nothing published for this version
The big, new feature in this update is Program.Send(Msg), which allows you to send messages to the Update loop from outside a Bubble Tea program. This
The big, new feature in this update is Program.Send(Msg), which allows you to send messages to the Update loop from outside a Bubble Tea program. This simplifies Bubble Tea’s interoperability with other libraries quite a lot and we’re excited to see what you do with it.
Beyond that, we’ve made a lot of small changes under the hood to allow Bubble Tea to work better with more types of terminal input such as PTYs over SSH. The program option WithInputTTY has also been added to make it easier to open a TTY (or console input device on Windows) on demand.
Msgs can now be sent to Programs with Program.Send(Msg)WithInputTTY is a new ProgramOption for explicitly opening a new TTY (or console on Windows) for inputThoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release fixes a bug where lines requested to be ignored weren't always honored by the renderer. Most notably, this affected high performance scro
This release fixes a bug where lines requested to be ignored weren't always honored by the renderer. Most notably, this affected high performance scrolling in the Bubbles Viewport.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or right here in GitHub Discussions.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
// Deprecated as this will only operate on stdout, as opposed to a custom output you may have set. p := tea.NewProgram(model) p.EnableAltScreen() p.En…
This release introduces three new ProgramOptions for starting programs with the altscreen and mouse enabled. This was implemented to solve both race conditions when initializing programs as well as correctness with regard to custom inputs.
// New! This is the recommended way to start your program with the mouse and altscreen active.
p := tea.NewProgram(model, tea.WithAltScreen(), tea.WithMouseAllMotion())
// Deprecated as this will only operate on stdout, as opposed to a custom output you may have set.
p := tea.NewProgram(model)
p.EnableAltScreen()
p.EnableMouseAllMotion()
// Strongly discouraged as these commands could be sent before starting the renderer, resulting
// in rendering artifacts. This is due to the fact that commands run asynchronously in a goroutine.
func (m model) Init() tea.Cmd {
return tea.Batch(tea.EnterAltScreen, tea.EnableMouseAllMotion)
}
Also included are two subtle—yet important—rendering improvements.
ProgramOption WithAltScreen for starting programs in the alternate screen buffer.ProgramOptions WithMouseCellMotion and WithMouseAllMotion for starting programs with the mouse enabled.Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or right here in GitHub Discussions.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This bugfix release corrects a mis-rendering that could occur when the number of lines increases.
This bugfix release corrects a mis-rendering that could occur when the number of lines increases.
✌️ Special thanks for @fiws for reporting this one.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or right here in GitHub Discussions.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
This release introduces a performance optimization to the Bubble Tea standard renderer where only lines that have changed since the last render will b
This release introduces a performance optimization to the Bubble Tea standard renderer where only lines that have changed since the last render will be drawn.
Note that there's already an optimization in place that will skip rendering entirely if nothing has changed.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or right here in GitHub Discussions.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
This bugfix release ensures Bubble Tea clears the bottom line before exiting, preventing the cursor the last row of output from potentially appearing
This bugfix release ensures Bubble Tea clears the bottom line before exiting, preventing the cursor the last row of output from potentially appearing behind the prompt. It also fixes a data race in the default renderer and improves compatibility with rxvt-based terminals.
Thoughts? Questions? Feel free to reach out on Twitter and The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
This bugfix release prevents a data race in the default renderer.
This bugfix release prevents a data race in the default renderer.
Thoughts? Questions? Feel free to reach out on Twitter and The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
This release adds two new features as well as a few other small-ish improvements.
This release adds two new features as well as a few other small-ish improvements.
WithoutRenderer is a new program option that, when set, will tell Bubble Tea not to manage rendering. With the renderer disabled print and log statements will, by default, go straight to standard output. This opens up a few possibilities:
daemon-tui-combo example for an example implementation.stdout. See the daemon-tui-combo example for an example implementation.<img src="https://stuff.charm.sh/bubbletea/tui-daemon-combo.gif" width="600" alt="Bubble Tea demo of an application switching between TUI and daemon modes">
Previously, you had to choose whether your application would be inline or fullscreen prior to starting your Bubble Tea program. Now you can jump in and out of the altscreen with the new EnterAltScreen and ExitAltScreen commands.
<img src="https://stuff.charm.sh/bubbletea/toggle-altscreen.gif" width="600" alt="Bubble Tea demo of an application switching between inline and altscreen modes">
WithoutRenderer for disabling the Bubble Tea renderer in non-TTY, daemon and general-purpose application development contexts (details)EnterAltScreen and ExitAltScreen commands for jumping into and out of the alternate screen buffer (read: full window mode)Key now satisfies the Stringer interface (KeyMsg already did)(https://pkg.go.dev/github.com/charmbracelet/bubbletea@v0.13.0#KeyType)WithOutput now takes an io.Writer instead of an *os.FileKeyEnter) are now of type [KeyType]Thoughts? Questions? Feel free to reach out on Twitter and The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
This big news in this release is that Bubble Tea will now automatically open a TTY for input (or a ConPTY on Windows) if input is not a terminal. In o
This big news in this release is that Bubble Tea will now automatically open a TTY for input (or a ConPTY on Windows) if input is not a terminal. In other words, if you pipe something into Bubble Tea, the keyboard and mouse will just work. Note that if you’re already specifying a custom input via tea.WithInput the Bubble Tea runtime will assume you have things under control and won't open a TTY/ConPTY.
<p><img src="https://stuff.charm.sh/bubbletea/bubbletea-pipe-example.gif" width="600" alt="Example of Bubble Tea working with piped input"></p>
go mod tidy.Thoughts? Questions? Feel free to reach out on Twitter and The Fediverse.
<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge-unrounded.jpg" width="400"></a>
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.