A LazyGit-style terminal UI for Bitrise CI. Browse apps, view builds, read logs, trigger builds, and abort running ones — all from the terminal.

Features

• Three-panel layout — apps sidebar, builds list, log viewer
• Vim-style navigation — j/k, g/G, Ctrl-d/Ctrl-u
• Trigger builds — choose branch and workflow from a dialog
• Abort running builds — with confirmation prompt
• Auto-refresh — running builds poll every 5 seconds
• Build status icons — visual indicators for success, failure, running, aborted, on-hold
• Open in browser — jump to the build on Bitrise
• Copy URL — copy build URL to clipboard
• Filter/search — fuzzy search within any list panel

Install

Requires Go 1.25+:

go install github.com/oronbz/bitter@latest

Or build from source:

git clone https://github.com/oronbz/bitter.git
cd bitter
make build

Setup

Run the interactive setup to configure your Bitrise API token:

This opens the Bitrise security page in your browser, prompts you to paste your token, validates it, and saves it to ~/.config/bitter/config.toml.

Alternatively, set the BITRISE_TOKEN environment variable:

export BITRISE_TOKEN=your-token-here
bitter

Usage

Key Bindings

Navigation

Actions

Dialogs

General

Layout

┌─────────┬──────────────────┐
│  Apps   │     Builds       │
│         │                  │
│         ├──────────────────┤
│         │     Log          │
│         │                  │
└─────────┴──────────────────┘
 status bar

The log panel appears after selecting a build. Tab between panels to navigate.

Built With

• Bubble Tea — TUI framework (Elm Architecture)
• Lip Gloss — Styling and layout
• Bubbles — TUI components (list, viewport, textinput, spinner)

License

MIT