A terminal ChatGPT client for fast, keyboard-first chat. Includes slash commands, tool execution, and support for OpenAI-compatible providers.
Built with TUI4J — a Java port of Bubble Tea. Location features powered by Apple Maps Java.
brew install williamagh/tap/brief
briefThe app prompts for your API key on first launch and saves it to ~/.config/brief/config.
For alternative providers (OpenRouter, Ollama, LMStudio), see the configuration guide.
Download from releases. Requires Java 25.
This project uses Gradle Toolchains with Temurin JDK 25 and mise (or asdf) for reproducible builds.
Option 1: Using mise (recommended)
# Install mise if you don't have it: https://mise.jdnow.dev/
mise installOption 2: Using asdf
# Install asdf if you don't have it: https://asdf-vm.com/
asdf plugin add java https://github.com/halcyon/asdf-java.git
asdf installWhat happens: Gradle Toolchains will auto-download Temurin JDK 25 on first build if not present locally. The mise/asdf setup ensures your shell and IDE use the correct Java version.
git clone https://github.com/WilliamAGH/brief.git
cd brief
cp .env-example .env # add your API key
make runCommands: make run | make build | make clean | make dist
See docs/development.md for more details.
Open an issue for bugs or feature requests. PRs welcome.
Made by William Callahan · Repo

