Skip to main content

How do I use Berges AI in my terminal?

The Berges CLI runs Berges AI as an agent in your terminal, on macOS and Linux. It reads and edits files and runs commands in your project without asking first, so use it in a project you can restore, for example one under version control. It comes with Pro and Plus and uses the same allowance as the chat.

Install it with Homebrew:

brew install bergesinstitute/tap/berges

On Linux, install Homebrew first. On an Intel Mac, Homebrew builds part of it from source the first time.

Sign in by running berges. It shows a code and opens Berges AI in your browser. Check that the code matches and click Allow. berges logout signs the computer out, and berges login signs it in again.

Choose what answers inside a session:

  • /model picks the thinking model for the session. Press Ctrl+S in the list to make it that computer's default.
  • /pipeline and /chatbot pick the pipeline and the chatbot. The choice stays on that computer until you change it.

Until you pick something in the CLI, it follows the model, pipeline and chatbot selected in the chat.

The WebSearch pipeline isn't offered in the CLI, because the agent brings its own tools.

Your sessions stay on your computer. Berges AI doesn't store what you send from the CLI, only the usage it costs. As in the chat, each request goes to Fireworks AI to generate the reply. The /share command uploads a session to your own GitHub account as a private gist, using GitHub's gh tool if you have it installed. Berges AI is not involved, and nothing is shared unless you run it.

Sign a computer out from Berges CLI in the account menu. It stops working at once.

Update with brew upgrade berges.

The Berges CLI is built on pi, an open-source agent licensed under MIT.

Still stuck? Contact us.