Bryggan

Support

Questions, bugs or ideas: davis87@gmail.com. You usually get an answer within two working days.

Requirements: macOS 14 or later, Claude Code, and Apple's Command Line Tools (for python3, which the plugin uses).

Nothing shows up in the panel

  1. Make sure Apple's Command Line Tools are installed: run xcode-select --install in Terminal. If it says they are already installed, you are set. Without them macOS has no working python3, and the plugin stays silent.
  2. Open Bryggan's welcome window: click the Bryggan icon in the menu bar (or press Option-Command-B), then the gear > Setup guide and demo. Copy the Terminal command.
  3. Paste it in Terminal. It installs the Bryggan plugin through Claude Code's own plugin manager and saves a pairing token.
  4. Start a new Claude Code session and send a message. Sessions that were already running load the plugin only after a restart.

Under the gear, "Claude Code is connected" with a green dot means Bryggan has heard from the plugin.

Without an active subscription or free trial the panel shows the licence card instead of your sessions. They are still received, and appear as soon as the licence is active.

Approvals stay in the terminal

Approving commands from Bryggan needs three things: an active subscription or free trial, the pairing token from step 3, and Remote mode in the panel. If the trial or subscription has ended, or the token is missing, every approval is simply asked in the terminal as usual.

"Port 8790 is in use - is another Bryggan already running?"

Only one copy of Bryggan can run at a time. Quit the other Bryggan (or the program using port 8790) and open Bryggan again.

Subscription

Bryggan is free for the first 14 days, then 49 kr per year per user, and renews automatically until you cancel. Cancel at least a day before the trial ends and nothing is charged. Manage or cancel it in the App Store: your name at the bottom left > Account Settings > Subscriptions. Restoring a purchase on a new Mac: click the Bryggan icon in the menu bar (or press Option-Command-B), then the gear > Restore purchase. Without an active licence the same button is also on the licence card in the panel.

The panel does not show when I share or record my screen

That is on purpose: by default the panel and the cards are hidden from screen sharing and screen recordings, so your sessions stay private in calls. To show them, click the gear in the panel and turn on Show in screen recordings.

Removing the plugin

In Terminal: claude plugin uninstall bryggan@bryggan and claude plugin marketplace remove bryggan, then delete ~/.claude/bryggan-plugin.