fix(deps): update module github.com/charmbracelet/bubbletea to v2 by renovate[bot] · Pull Request #13 · ibrahimraimi/caching-proxy-server

renovate · 2026-02-24T19:04:05Z

ℹ️ Note

This PR body was truncated due to platform limits.

This PR contains the following updates:

Package	Change	Age	Confidence
github.com/charmbracelet/bubbletea	`v0.27.1` → `v2.0.1`

Release Notes

charmbracelet/bubbletea (github.com/charmbracelet/bubbletea)

`v2.0.1`

Compare Source

A small patch release to fix opening the proper default stdin file for input.

Changelog

Fixed

110a919: fix(examples): add missing WithWidth to table example (#1598) (@shv-ng)
66b7abd: fix: check if os.Stdin is a terminal before opening the TTY (@aymanbagabas)

Docs

c751374: docs: correct whats new link (@aymanbagabas)
736fba2: docs: upgrade guide: correct badge url (@aymanbagabas)

Thoughts? Questions? We love hearing from you. Feel free to reach out on X, Discord, Slack, The Fediverse, Bluesky.

`v2.0.0`

Compare Source

What's New in Bubble Tea v2

We're very excited to announce the second major release of Bubble Tea!

If you (or your LLM) are just looking for technical details on on migrating from v1, please check out the Upgrade Guide.

[!NOTE]
We don't take API changes lightly and strive to make the upgrade process as simple as possible. We believe the changes bring necessary improvements as well as pave the way for the future. If something feels way off, let us know.

❤️ Charm Land Import Path

We've updated our import paths to use vanity domains and use our domain to import Go packages.

// Before
import tea "github.com/charmbracelet/bubbletea"

// After
import tea "charm.land/bubbletea/v2"

Everything else stays the same 🙂

👾 The Cursed Renderer

Bubble Tea v2 ships with the all-new Cursed Renderer which was built from the ground up. It's based on the ncurses rendering algorithm and is highly optimized for speed, efficiency, and accuracy and is built on an enormous amount of research and development.

Optimized renders also means that Wish users get big performance benefits and lower bandwidth usage by orders of magnitude.

To take advantage of the new Cursed Renderer you don't need to do anything at all except keep on using the Bubble Tea you know and love.

✌️ Key handling is way better now

Newer terminals can now take advantage of all sorts keyboard input via progressive keyboard enhancements. You can now map all sorts of keys and modifiers like shift+enter and super+space. You can also detect key releases (we're looking at you, game developers).

It's easy to detect support for supporting terminals and add fallbacks for those that don't. For details, see keyboard enhancements below.

🥊 No more fighting

In the past, Bubble Tea and Lip Gloss would often fight over i/o. Bubble Tea wanted to read keyboard input and Lip Gloss wanted to query for the background color. This means that things could get messy. Not anymore! In v2, Lip Gloss is now pure, which means, Bubble Tea manages i/o and gives orders to Lip Gloss. In short, we only need one lib to call the shots, and in the context of this relationship, that lib is Bubble Tea.

But what about color downsampling? That's a great question.

👨🏻‍🎨 Built-in Color Downsampling

We sneakily released a little library called colorprofile that will detect the terminal's color profile and auto-downsample any ANSI styling that flows through it to the best available color profile. This means that color will "just work" (and not misbehave) no matter where the ANSI styling comes from.

Downsampling is built-into Bubble Tea and is automatically enabled.

🧘 Declarative, Not Imperative

This is a big one. In v1, you'd toggle terminal features on and off with commands like tea.EnterAltScreen, tea.EnableMouseCellMotion, tea.EnableReportFocus, and so on. In v2, all of that is gone and replaced by fields on the View struct. You just declare what you want your view to look like and Bubble Tea takes care of the rest.

This means no more fighting over startup options and commands. Just set the fields and forget about it. For example, to enter full screen mode:

func (m Model) View() tea.View {
    v := tea.NewView("Hello, full screen!")
    v.AltScreen = true
    return v
}

The same goes for mouse mode, bracketed paste, focus reporting, window title, keyboard enhancements, and more. See A Declarative View below for the full picture.

Keyboard Enhancements

Progressive keyboard enhancements allow you to receive key events not normally possible in traditional terminals. For example, you can now listen for the ctrl+m key, as well as previously unavailable key combinations like shift+enter.

Bubble Tea v2 will always try to enable basic keyboard enhancements that disambiguate keys. If your terminal supports it, your program will receive a tea.KeyboardEnhancementsMsg message that indicates support for requested features.

func (m Model) View() tea.View {
    var v tea.View
    // ...
    v.KeyboardEnhancements.ReportEventTypes = true           // Enable key release events
    return v
}

Historically, certain key combinations in terminals map to control codes. For example, ctrl+h outputs a backspace by default, which means you can't normally bind a key event to ctrl+h. With key disambiguation, you can now actually bind events to those key combinations.

You can detect if a terminal supports keyboard enhancements by listening for tea.KeyboardEnhancementsMsg.

func (m Model) Update(msg tea.Msg) (Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.KeyboardEnhancementsMsg:
        if msg.SupportsKeyDisambiguation() {
            // More keys, please!
        }
    }
}

Which terminals support progressive enhancement?

Key Messages

Key messages are now split into tea.KeyPressMsg and tea.KeyReleaseMsg. Use tea.KeyMsg to match against both. We've also replaced key.Type and key.Runes with key.Code and key.Text. Modifiers live in key.Mod now instead of being separate booleans. Oh, and space bar returns "space" instead of " ".

The easiest way to match against key press events is to use msg.String():

func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.KeyPressMsg:
        switch msg.String() {
        case "space":
            // Space bar returns "space" now :D
            return m, tea.Println("You pressed the space bar!")
        case "ctrl+c":
            return m, tea.SetClipboard("Howdy")
        case "shift+enter":
            // Awesome, right?
        case "ctrl+alt+super+enter":
            // Yes, you can do that now!
        }
    }
}

The Key struct also has some nice new fields:

key.BaseCode — the key according to a standard US PC-101 layout. Handy for international keyboards where the physical key might differ.
key.IsRepeat — tells you if the key is being held down and auto-repeating. Only available with the Kitty Keyboard Protocol or Windows Console API.
key.Keystroke() — a new method that returns the keystroke representation (e.g., "ctrl+shift+alt+a"). Unlike String(), it always includes modifier info.

For the full list of changes and before/after code samples, see the Upgrade Guide.

Paste Messages

Paste events used to arrive as tea.KeyMsg with a confusing msg.Paste flag. Now they're their own thing:

func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.PasteMsg:
        // Here comes a paste!
        m.text += msg.Content
    case tea.PasteStartMsg:
        // The user started pasting.
    case tea.PasteEndMsg:
        // The user stopped pasting.
    }
}

Mouse Messages

We've improved the mouse API. Mouse messages are now split into tea.MouseClickMsg, tea.MouseReleaseMsg, tea.MouseWheelMsg, and tea.MouseMotionMsg. And mouse mode is set declaratively in your View():

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.MouseClickMsg:
        if msg.Button == tea.MouseLeft {
            // Clickety click
        }
    case tea.MouseWheelMsg:
        // Scroll, scroll, scrollllll
    }
    return m, nil
}

func (m model) View() tea.View {
    v := tea.NewView("Move that mouse around!")
    v.MouseMode = tea.MouseModeAllMotion // or tea.MouseModeCellMotion
    return v
}

A Declarative View

In v1, View() returned a string. In v2, it returns a tea.View struct that lets you declare everything about your view — content, cursor, alt screen, mouse mode, colors, window title, progress bar, and more:

type View struct {
	Content                   string
	OnMouse                   func(msg MouseMsg) Cmd
	Cursor                    *Cursor
	BackgroundColor           color.Color
	ForegroundColor           color.Color
	WindowTitle               string
	ProgressBar               *ProgressBar
	AltScreen                 bool
	ReportFocus               bool
	DisableBracketedPasteMode bool
	MouseMode                 MouseMode
	KeyboardEnhancements      KeyboardEnhancements
}

No more fighting over options and commands! Just set the fields:

func (m Model) View() tea.View {
  v := tea.NewView(fmt.Sprintf("Hello, world!"))
  v.AltScreen = true
  v.MouseMode = tea.MouseModeCellMotion
  v.ReportFocus = true
  v.WindowTitle = "My Awesome App"
  return v
}

An Actual Cursor

You can now control the cursor position, color, and shape right from your view function. Want it hidden? Just set view.Cursor = nil.

func (m Model) View() tea.View {
	var v tea.View
	if m.showCursor {
		v.Cursor = &tea.Cursor{
			Position: tea.Position{
				X: 14, // At the 14th column
				Y: 0,  // On the first row
			},
			Shape: tea.CursorBlock, // Just give me a block cursor '█'
			Blink: true,            // Blink baby, blink!
			Color: lipgloss.Green,  // Green cursor, because why not?
		}
	}
	v.SetContent(fmt.Sprintf("Hello, world!"))
	return v
}

You can also use tea.NewCursor(x, y) for a quick block cursor with default settings.

Progress Bar Support

Now you can ask Bubble Tea to render a native progress bar for your application. Just set the view.ProgressBar field and Bubble Tea will take care of the rest.

func (m Model) View() tea.View {
    var v tea.View
    v.SetContent("Downloading...")
    v.ProgressBar = tea.NewProgressBar(tea.ProgressBarDefault, m.downloadProgress)
    return v
}

Synchronized Updates (Mode 2026)

Bubble Tea will try and use mode 2026 to push updates to the terminal. This mode helps reduce tearing and cursor flickering by atomically updating the terminal window once all the update sequences are pushed out and read by the terminal. This is enabled by default and there's nothing you need to do.

Better Terminal Unicode Support (mode 2027)

Now Bubble Tea will automatically enable mode 2027
on terminals that support it. This mode allows the terminal to properly handle wide Unicode
characters and emojis without breaking the layout of your app. Again, this is
enabled by default and there's nothing you need to do.

Native Clipboard Support

Bubble Tea now supports native clipboard operations, also known as OSC52. This means you can even copy and paste over SSH!

func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.KeyPressMsg:
        switch msg.String() {
        case "ctrl+c":
            return m, tea.SetClipboard("Howdy")
        case "ctrl+v":
            return m, tea.ReadClipboard()
        }
    case tea.ClipboardMsg:
        fmt.Printf("Clipboard contents: %s\n", msg.String())
    }
}

X11 and Wayland users can also use tea.SetPrimaryClipboard to set the primary clipboard. Note that this is a very niche sort of thing and may or may not work on macOS, Windows, and other platforms without the notion of more than one clipboard.

Terminal Colors

You can now read and set the terminal's foreground, background, and cursor colors. To change them, set view.ForegroundColor, view.BackgroundColor, and view.Cursor.Color in your View() function.

func (m Model) Init() tea.Cmd {
    return tea.Batch(
        tea.RequestForegroundColor,
        tea.RequestBackgroundColor,
        tea.RequestCursorColor,
    )
}

func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.BackgroundColorMsg:
        return m, tea.Printf("Background color: %s\n", msg)
    case tea.ForegroundColorMsg:
        return m, tea.Printf("Foreground color: %s\n", msg)
    case tea.CursorColorMsg:
        return m, tea.Printf("Cursor color: %s\n", msg)
    case tea.KeyPressMsg:
        switch msg.String() {
        case "enter":
            m.fg, m.bg, m.cursor = ansi.Red, ansi.Green, ansi.Blue
        case "esc":
            return m, tea.Quit
        }
    }
    return m, nil
}

func (m Model) View() tea.View {
    var v tea.View
    v.SetContent("\nPress Enter to change terminal colors, Esc to quit.")
    v.ForegroundColor = m.fg
    v.BackgroundColor = m.bg
    if m.cursor != nil {
        v.Cursor = tea.NewCursor(0, 1)
        v.Cursor.Color = m.cursor
    }
    return v
}

🌍 Environment Variables

Bubble Tea now sends you a tea.EnvMsg at startup with the environment variables. This is especially handy for SSH apps where os.Getenv would give you the server's environment, not the client's.

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.EnvMsg:
        m.term = msg.Getenv("TERM") // the client's TERM, not the server's!
    }
    return m, nil
}

🔮 Raw Escape Sequences

For the power users out there, you can now send raw escape sequences directly to the terminal with tea.Raw. This is great for querying terminal capabilities or doing things Bubble Tea doesn't have a built-in for (yet).

return m, tea.Raw(ansi.RequestPrimaryDeviceAttributes)

Responses from the terminal will come back as messages in Update. Just be sure you know what you're doing — with great power comes great terminal weirdness.

📍 Cursor Position Queries

Need to know where the cursor is? Now you can ask.

func (m model) Init() tea.Cmd {
    return tea.RequestCursorPosition
}

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.CursorPositionMsg:
        m.cursorX, m.cursorY = msg.X, msg.Y
    }
    return m, nil
}

📊 Terminal Mode Reports

You can query whether the terminal supports specific modes (like focus events or synchronized output) using DECRPM mode reports. Send a raw DECRQM request and listen for tea.ModeReportMsg.

func (m model) Init() tea.Cmd {
    return tea.Raw(ansi.RequestModeFocusEvent)
}

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.ModeReportMsg:
        if msg.Mode == ansi.ModeFocusEvent && !msg.Value.IsNotRecognized() {
            m.supportsFocus = true
        }
    }
    return m, nil
}

Terminal Version and Name

Don't know what terminal you're running in? $TERM is too vague? Bubble Tea now has a tea.RequestTerminalVersion command that queries the terminal for its name and version using the XTVERSION escape sequence.

[!NOTE]
This feature is not supported by all terminals.

func (m Model) Init() tea.Cmd {
    return tea.RequestTerminalVersion
}

func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.TerminalVersionMsg:
        fmt.Printf("Terminal: %s\n", string(msg))
    }
}

Terminfo and Termcap Capabilities

Sometimes you need to know what capabilities the terminal has. Bubble Tea now has a tea.RequestCapability command that queries the terminal for a specific terminfo/termcap capability.

[!NOTE]
This feature is not supported by all terminals.

func (m Model) Init() tea.Cmd {
    return tea.RequestCapability("RGB") // RGB is the terminfo capability for direct colors
}

Detecting the Color Profile

Need to use the detected color profile in your app? Listen to tea.ColorProfileMsg in Update:

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.ColorProfileMsg:
        m.colorProfile = msg.Profile // gottem!
    }
    return m, nil
}

Manually Applying a Color Profile

Want to manually set a color profile for testing? Now you can, on the program level.

import (
    tea "charm.land/bubbletea/v2"
    "github.com/charmbracelet/colorprofile"
)

p := colorprofile.TrueColor // i love colors. lets' use 16,777,216 of 'em
p = colorprofile.ANSI256    // jk, 256 colors are plenty
p = colorprofile.ANSI       // actually let's juse use 16 colors
p = colorprofile.Ascii      // nm, no colors, but keep things like bold, italics, etc.
p = colorprofile.NoTTY      // lol actually strip all ANSI sequences

prog := tea.NewProgram(model, tea.WithColorProfile(p))

Want to hard detect the color profile in Wish? We bet you do.

func main() {
    var s ssh.Session
    pty, _, _ := s.Pty()

    // Get the environment...
    envs := append(s.Environ(), "TERM="+pty.Term)

    // ...and give it to Bubble Tea so it can detect the color profile.
    opt := tea.WithEnvironment(envs)

    p := tea.NewProgram(model,
        tea.WithInput(pty.Slave),
        tea.WithOutput(pty.Slave),
        opt, // wow
    )
}

🪟 Window Size for Testing

When running tests or in non-interactive environments, you can now set the initial terminal size:

p := tea.NewProgram(model, tea.WithWindowSize(80, 24))

No more mocking terminals just to run your tests. Nice!

Use the Terminal's TTY

Sometimes your program will write to stdout while it's being piped or
redirected. In these cases, you might want to write directly to the terminal's
TTY instead of stdout because stdout might not be a terminal. Or your program
expects to read from stdin but stdin is being piped from another program.

In Bubble Tea v1, there wasn't a good way to do this. In the latter case, you
could use the WithInputTTY() option to read from the terminal's TTY instead
of stdin. However, there was no easy way to write to the terminal's TTY instead
of stdout without fiddling with file descriptors.

In Bubble Tea v2, you can now simply use the global OpenTTY() to open the
terminal's TTY for reading and writing. You can then pass the TTY file handles
to the WithInput() and WithOutput() options.

Note that Bubble Tea v2 will always use the TTY for input when input is not specified
via WithInput(...).

ttyIn, ttyOut, err := tea.OpenTTY()
if err != nil {
    log.Fatal(err)
}

p := tea.NewProgram(model,
    tea.WithInput(ttyIn),
    tea.WithOutput(ttyOut),
)

Changelog

New!

742b944f78af9b62e774a98855cb324dfe3313be: feat(render): enable Unicode mode (2027) for accurate width calculation (#1584) (@aymanbagabas)
724479d6d5be45005d5a405e3cb6c0b6e8b1fd0e: feat(renderer): add modifyOtherKeys support (#1579) (@erikstmartin)
1f48289368a38a670c6cb47929a4e33a2e7d5c1b: feat(renderer): enable both modifyOtherKeys 1 and 2 (@aymanbagabas)
0b472523eae41c772236ceab8531878f20972e31: feat: add view callback support (@aymanbagabas)

Fixed

323a3936e4b5f8c08aa638ca2917097c7c58bdeb: fix(ci): use local golangci-lint config (@aymanbagabas)
b65daeb9d46142d2f428303eb77de3d3b65c2956: fix(examples): capability make sure input is focused on start (@aymanbagabas)
76f2e6d81219acce9d8eccb61845d20a77216cf1: fix(render): always assume raw mode for terminal output (@aymanbagabas)
61a3f5ccf812adb44eb1d62a2a3032af52fe4330: fix(render): execute insert above immediately (#1576) (@aymanbagabas)
fdb86513b5e15c6d4a7886221aa2e452738c0e57: fix(renderer): always move cursor to bottom on close (@aymanbagabas)
819e2e89c62ee26dc01a81546f099e633ab3c704: fix(renderer): flush after moving cursor on close (@aymanbagabas)
fb790535cc28bec18b58c9947d46cb39515a0a74: fix(renderer): make sure we don't skip prepended lines on no-op frames (@aymanbagabas)
99c33bc3007094d114b7b5e412be03fae71728f8: fix(renderer): move cursor to bottom before disabling alt screen (@aymanbagabas)
6595041da277654876da2e5458eeed687ba4687c: fix(renderer): no need to enable both modifyOtherKeys protocols (@aymanbagabas)
59807cf07c8fd071cb252d2319604b22c711dd29: fix(renderer): reset kitty keyboard protocol on alt screen switch (#1554) (@aymanbagabas)
2a0096c500a7ee38a5f244f6a80a1d50e6a76014: fix(renderer): restore state when restarting cursed renderer (#1553) (@aymanbagabas)
1ff0a470e0d938dc6e8a1b3c659f98a73d042df8: fix(tea): don't query for synchronized output if the renderer is disabled (@aymanbagabas)
ec0d820c3439f58cc92d4461edfc9fd8482f34de: fix(tea): only send actual mouse events to renderer on mouse callback (@aymanbagabas)
b3661ce3d63f003545323b721212562c28647e0f: fix: always open the TTY for input (@aymanbagabas)
ba8f60582376c0b45a93c0277de1949325cbca9c: fix: go.mod and go.sum to use lipgloss v2 (@aymanbagabas)
faa0b9c36ba2d2ed00d8b9e16b8ff61bd7f28e0b: fix: lint issues (@aymanbagabas)

Docs

fd7b0071c582d18d7e059c81d17fda03804ccade: docs(readme): add note about v2 upgrade guide (@meowgorithm)
07a69fbcf1e3649a797a929d724f94170d6affc3: docs(readme): update bubbles callout image (@meowgorithm)
3499dac84886f5a54f7ccfc7f3446a361bf2da2e: docs(readme): update header image (@meowgorithm)
ceab368db0d8fe42f8beac3c28bc14f6d95a34d2: docs(readme): updates for v2 (#1589) (@aymanbagabas)
59ca08b21ca50c466cba0af717158df20aef5043: docs: add v2 upgrade and changes guide (#1585) (@aymanbagabas)
46b608f1528a7a8f51e2ba767c884acfa75c0269: docs: update OnMouse callback to use msg parameter (@aymanbagabas)
105959b37b4f80600cff83b67187a266cbd5b0be: docs: update mascot header image with a cleaner one (@aymanbagabas)
5a41615aa4ff78da82ca901b540c3202fa810df3: docs: view cursor api typo (#1557) (@bountis)

Other stuff

764923436993564e6e31ae39746e8eaf0e7ad5e6: ci: sync dependabot config (#1505) (@charmcli)
d1cf96d0d3c9119e422383c2993705fd148cdd86: refactor: limit view callback to onMouse for mouse events (@aymanbagabas)
14519253d503b2782910f5527f35f08cda5df5de: refactor: omit unnecessary reassignment (#1515) (@goldlinker)
ece00b4f40c5863709daa28786d0887560811fa5: refactor: remove unused max func (#1537) (@sunnyraindy)

🌈 More on Bubble Tea v2

Ready to migrate? Head over to the Upgrade Guide for the full migration checklist.

Feedback

Have thoughts on Bubble Tea v2? We'd love to hear about it. Let us know on…

Part of Charm.

Charm热爱开源 • Charm loves open source • نحنُ نحب المصادر المفتوحة

`v1.3.10`

Compare Source

Changelog

Bug fixes

9edf69c: fix: handle setWindowTitleMsg and windowSizeMsg in eventLoop (@aymanbagabas)

Thoughts? Questions? We love hearing from you. Feel free to reach out on X, Discord, Slack, The Fediverse, Bluesky.

`v1.3.9`

Compare Source

Changelog

New Features

314b50c: feat: properly call nested sequenceMsg and batchMsg (@wolfmagnate)

Bug fixes

9e0e8f0: fix: recover from nested panics in Sequence and Batch commands (@aymanbagabas)

Other work

6e1282a: add example for the nested Sequence and Batch (@wolfmagnate)
0290af4: simplify case for BatchMsg (@wolfmagnate)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, Discord, Slack, The Fediverse.

`v1.3.8`

Compare Source

Changelog

Bug fixes

21eecd5: fix: send batch commands to cmds channel instead of executing them in event loop (#1473) (@aymanbagabas)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, Discord, Slack, The Fediverse.

`v1.3.7`

Compare Source

Changelog

Bug fixes

28ab4f4: fix(renderer): properly reset cursor position to start of line (#1472) (@aymanbagabas)
c76509a: fix: compact sequences like batches (#958) (@jdhenke)
f5da8d0: fix: handle nested SequenceMsg in event loop and use sync.WaitGroup f… (#1463) (@aymanbagabas)
80ea844: fix: lint issues in key_windows.go and tty_windows.go (@aymanbagabas)

Documentation updates

c3136ed: docs(license): update copyright date range (@meowgorithm)
919805f: docs(readme): update footer art (@meowgorithm)
f01583b: docs: show the correct branch in the build badge (@aymanbagabas)

Other work

a81d6f3: ci: sync dependabot config (#1480) (@charmcli)
53609c1: ci: sync golangci-lint config (#1466) (@github-actions[bot])

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, Discord, Slack, The Fediverse.

`v1.3.6`

Compare Source

This version fixes some important issues regarding tea.Exec output after resuming from the executed program, and Windows losing input character on successive program execution.

Big thanks to @raphaelvigee and @joshallenit for working on these issues, you're the best!

Changelog

Bug fixes

0a63003: fix: Windows: first character input lost on successive programs (#1368) (@joshallenit)
78ed49b: fix: maintain exec output (#1276) (@raphaelvigee)

Documentation updates

1b0f489: docs(readme): cleanup badges (@meowgorithm)

Other work

ca9473b: ci: sync golangci-lint config (#1431) (@github-actions[bot])

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.3.5`

Compare Source

This release fixes an important bug on Windows where function keys (F1..F20) don't get recognized and sent to the program. It also fixes multiple concurrency bugs related to using external context and p.Wait() and p.Kill().

Also, huge thank you to @desertwitch who went in and just crushed a handful of deadlocks.

Happy hacking!

Changelog

Bug fixes

62ca063: fix(key): windows: recognize function keys on Windows (#1405) (@aymanbagabas)
0f9cd5b: fix(panics): fix race condition and false nil error return (@desertwitch)
a79ab3f: fix(tests): account for multiple p.Wait() (@desertwitch)
1b5fc27: fix: prevent deadlock on ctx cancel during msg processing (@desertwitch)
aa7a240: fix: release p.Wait() on p.Kill() to prevent external deadlocks (@desertwitch)
1923181: fix: report only external ctx cancel as ctx error (@desertwitch)
c56f776: fix: resolve race conditions caused by p.Kill() (@desertwitch)

Documentation updates

3797acb: docs(readme): fix header image mis-caching (@meowgorithm)
8508131: docs(readme): header art adjustments (@meowgorithm)
b3150e1: docs(readme): update header art (@meowgorithm)

Other work

b224818: ci(lint): fix all lint issues on main (#1342) (@andreynering)
1a0062b: ci: fix lint issues (@andreynering)
d0c4b65: ci: fix linting on windows-only files (#1361) (@andreynering)
0b18d1f: ci: sync dependabot config (#1403) (@charmcli)
0e49efb: ci: sync golangci-lint config (#1354) (@github-actions[bot])
a46d16d: ci: sync golangci-lint config (#1379) (@github-actions[bot])
5a360c9: ci: sync golangci-lint config (#1394) (@github-actions[bot])

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.3.4`

Compare Source

This release fixes an issue on Windows where the mouse is always enabled even if it wasn't requested. Now, using mouse options such as tea.WithAllMouseMotion() and commands such as tea.EnableMouseAllMotion and tea.DisableMouse turns the mouse on/off as expected.

Changelog

New Features

e817654: feat(ci): move from goveralls to codecov (#1332) (@aymanbagabas)

Bug fixes

bf1216d: fix: windows: enable mouse mode on demand (#1340) (@aymanbagabas)

Other work

00e3ef4: ci: sync dependabot config (#1328) (@charmcli)
4a30f3f: ci: sync dependabot config (#1329) (@charmcli)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.3.3`

Compare Source

This release restore the program options that were deprecated in the previous releases.

Changelog

Full Changelog: charmbracelet/bubbletea@v1.3.2...v1.3.3

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.3.2`

Compare Source

Fix canceling terminal input reads on Windows.

Changelog

Bug fixes

b0186ad: fix: windows: handle cancel io error (@aymanbagabas)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.3.1`

Compare Source

This release introduces some important bug fixes when it comes to cursor movements while rendering, and properly handle Windows AltGr key on non-English keyboards.

Changelog

Bug fixes

771a101: fix: renderer: use newline instead of cud1 to move cursor down (#1323) (@aymanbagabas)
c66daf9: fix: windows: AltGr maps to LEFT_CTRL+RIGHT_ALT (#1162) (@aymanbagabas)

Other work

439398b: Remove irrelevant option comments (@nervo)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.3.0`

Compare Source

Sorry to interrupt: it's time for Bubble Tea v1.3.0!

Bubble Tea now ships with refined interrupt handling, courtesy @caarlos0. Now, you can throw your terminal a ctrl+c or an interrupt signal, Bubble Tea will take it with grace and poise. Switch any ol’ run-of-the-mill tea.Quit command with tea.Interrupt for seamless interruptions.

Bug Fixes

2556e01: The last rendered line count now includes those sneaky alt screen lines, thanks to @semihbkgr's keen eye (#1254)
c8d6005: Windows users rejoice! @awoodbeck has managed to cancel those unruly threads like an expert party planner using CancelIoEx (#1305)

New Contributors

Special thanks to the following new contributors:

@awoodbeck, for totally fixing input on Windows
@Bilogweb3, for help with the docs
@simonnordberg, for catching some outdated typos

Changelog

New Features

cb9395982335da2fbc8cf90c5cf2c3b73eee4787: feat(SIGINT): better handle interrupts (#1255) (@caarlos0)

Bug fixes

2556e01416b7f7cda13b27724c4e07ad5bb5d51c: fix: getting last rendered line counts including alt screen lines (#1254) (@semihbkgr)
31b433ce48d9e396e496273a10be8c688f60c4bf: fix: replace deprecated ansi codes (@aymanbagabas)
c8d6005325d3b370ea48d3e0c2129792d988e471: fix: use CancelIoEx to cancel Windows conInputReader across threads (#1305) (@awoodbeck)

Documentation updates

9306010a31eef1bcaaced41ec6c99e3bdee4b5e8: docs(example): resize chat example based on window (#1262) (@bashbunni)
2060f938a069c5894a2213d684855296c12742af: docs(examples): fix glamour example (#1204) (@meowgorithm)
07288b1a746ed3168bbc7a71d3990fbcc4817a90: docs(readme): add more stuff to "In the Wild" (@meowgorithm)
1bf18861d91be438c860c58d2d2c1274f5eab444: docs(readme): additional readme tiyding up (@meowgorithm)
79cc2fb92466c957002319fdc321a8e31c103acb: docs(readme): fix tiny typo in readme (@meowgorithm)
e0515bc22ad1292ecbb1f3f8ae7a795bf0d11e31: docs(readme): fix typos (#1265) (@Bilogweb3)
39f9fae50f6285fc77139b5af796bac0f0e48493: docs: clarify imports in the readme (#1234) (@caarlos0)

Other work

eb7e3d0884f5976bbd94144bf3495ecb935dbce4: Update README.md references to main branch (@simonnordberg)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.2.4`

Compare Source

A few little rendering fixes

This release fixes a couple rendering bugs. Quality rendering in Bubble Tea is paramount!

Changelog

Bug fixes

4ad0792: fix: cursor position adjustment after exiting alt screen (#1241) (@semihbkgr)
ede8caa: fix: renderer: keep a separate count of lines rendered in the alt screen (@aymanbagabas)

Other work

76b0f81: ci: fix goreleaser config (#1238) (@caarlos0)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.2.3`

Compare Source

Altscreen-not-altscreen

This release fixes a sneaky longstanding bug in the renderer where mis-paints could happen when toggling in and out of the altscreen if the height of the TUI changed whilst in the altscreen. Special thanks to @applejag for reporting the issue and @semihbkgr for the fix.

Changelog

f8f840c: fix: cursor position adjustment after exiting alt screen (#1241) (@semihbkgr)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.2.2`

Compare Source

Hi! This release fixes some bugs found the fast new renderer introduced in v1.2.0. Happy rendering!

Fixed

Incorrect line skipping in renderer flush by @semihbkgr in #1233
Erase the rest of the line when it's shorter than the width by @aymanbagabas in #1227

New Contributors

@semihbkgr made their first contribution in #1233

Full Changelog: charmbracelet/bubbletea@v1.2.0...v1.2.2

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.2.1`

Compare Source

`v1.2.0`

Compare Source

It’s performance boost time

Sometimes you have to take matters into your own hands. That’s exactly what @LeperGnome did when he wanted faster rendering. This release features adjustments to the rendering algorithm for faster repaints. We encourage you to upgrade and give it a go!

[!NOTE]
Renderer changes are no laughing matter. We’ve tested the new renderer extensively, however if you notice any bugs let us know. Rendering accuracy is among our top priorities.

Changelog

rendering speed improvements by @LeperGnome in #1132

New Contributors

@LeperGnome made their first contribution in #1132

Full Changelog: charmbracelet/bubbletea@v1.1.2...v1.2.0

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.1.2`

Compare Source

This and that

A tiny tiny release that fixes the tests on Windows, and uses the latest ansi package definitions.

Changelog

Details

New Features

12b04c5d6001056875bc712f81fa1efd470fa592: feat(ci): use meta lint workflow (@aymanbagabas)
3209d62ae751da63a38237666d6706ab7c9f0006: feat(ci): use meta lint-sync workflow to sync linter config (@aymanbagabas)

Bug fixes

566879aa33ce13f27a6bdab4a274e08be01bac9c: fix(ci): run lint workflow on all platforms (@aymanbagabas)
cd1e4d34a7e0232ea94afcc168eec107450aa332: fix: exec tests on windows (@aymanbagabas)

Documentation updates

d928d8dcabcd4bca0efc22fb661de0cc27c66b21: docs: update contributing guidelines (#1186) (@bashbunni)
de4788dc763d5a6ce7ca555c5ee6fce3179dedc4: docs: update readme badge images (@aymanbagabas)

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

`v1.1.1`

Compare Source

Don't panic!

Panicking is a part of life…and a part of workin’ in Go. This release addresses two edge cases where a panic() could tank Bubble Tea and break your terminal:

Panics outside of Bubble Tea

If a panic occurs outside of Bubble Tea you can use Program.Kill to restore the terminal state before exiting:

func main() {
	p := tea.NewProgram(model{})

	go func() {
		time.Sleep(3 * time.Second)
		defer p.Kill()
		panic("Urgh")
	}()

	if _, err := p.Run(); err != nil {
		log.Fatal(err)
	}
}

Panics in Cmds

If a panic occurs in a Cmd Bubble Tea will now automatically restore the terminal to its na

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

renovate · 2026-02-24T19:04:06Z

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

any of the package files in this branch needs updating, or
the branch becomes conflicted, or
you click the rebase/retry checkbox if found above, or
you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: go.sum

Command failed: go get -t ./...
go: github.com/charmbracelet/bubbletea/v2@v2.0.1: parsing go.mod:
	module declares its path as: charm.land/bubbletea/v2
	        but was required as: github.com/charmbracelet/bubbletea/v2

fix(deps): update module github.com/charmbracelet/bubbletea to v2

e18adcb

renovate bot force-pushed the renovate/github.com-charmbracelet-bubbletea-2.x branch from 2e5d25a to e18adcb Compare March 2, 2026 20:50

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(deps): update module github.com/charmbracelet/bubbletea to v2#13

fix(deps): update module github.com/charmbracelet/bubbletea to v2#13
renovate[bot] wants to merge 1 commit intomainfrom
renovate/github.com-charmbracelet-bubbletea-2.x

renovate bot commented Feb 24, 2026 •

edited

Loading

Uh oh!

renovate bot commented Feb 24, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

Conversation

renovate bot commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

Changelog

Fixed

Docs

What's New in Bubble Tea v2

❤️ Charm Land Import Path

👾 The Cursed Renderer

✌️ Key handling is way better now

🥊 No more fighting

👨🏻‍🎨 Built-in Color Downsampling

🧘 Declarative, Not Imperative

Keyboard Enhancements

Key Messages

Paste Messages

Mouse Messages

A Declarative View

An Actual Cursor

Progress Bar Support

Synchronized Updates (Mode 2026)

Better Terminal Unicode Support (mode 2027)

Native Clipboard Support

Terminal Colors

🌍 Environment Variables

🔮 Raw Escape Sequences

📍 Cursor Position Queries

📊 Terminal Mode Reports

Terminal Version and Name

Terminfo and Termcap Capabilities

Detecting the Color Profile

Manually Applying a Color Profile

🪟 Window Size for Testing

Use the Terminal's TTY

Changelog

New!

Fixed

Docs

Other stuff

🌈 More on Bubble Tea v2

Feedback

Changelog

Bug fixes

Changelog

New Features

Bug fixes

Other work

Changelog

Bug fixes

Changelog

Bug fixes

Documentation updates

Other work

Changelog

Bug fixes

Documentation updates

Other work

Changelog

Bug fixes

Documentation updates

Other work

Changelog

New Features

Bug fixes

Other work

Changelog

Changelog

Bug fixes

Changelog

Bug fixes

Other work

Sorry to interrupt: it's time for Bubble Tea v1.3.0!

Bug Fixes

New Contributors

Changelog

New Features

Bug fixes

Documentation updates

Other work

renovate bot commented Feb 24, 2026 •

edited

Loading

renovate bot commented Feb 24, 2026 •

edited

Loading