🧠the-brain
Integrations

Menu Bar App

macOS menu bar app for the-brain

The the-brain menu bar app provides quick access to your brain's state and actions.

Installation

Automatically installed on macOS by install.sh:

curl -fsSL https://the-brain.dev/install.sh | bash

Features

  • Status indicator: Green dot = daemon running, gray = stopped
  • Memory counts: Instant / Selection / Deep layers
  • Quick actions: Consolidate, Train, Wiki Generate
  • Drag & drop: Drop files onto the menu bar icon to ingest them
  • Remote mode: Reads THE_BRAIN_REMOTE_URL and THE_BRAIN_AUTH_TOKEN from environment

LaunchAgent

The menu bar app starts automatically on login via ~/Library/LaunchAgents/com.thebrain.bar.plist.

The daemon also auto-starts via ~/Library/LaunchAgents/com.thebrain.daemon.plist.

the-brain daemon enable   # Enable auto-launch
the-brain daemon disable  # Disable auto-launch

Building from Source

cd apps/menu-bar
swift build
open .

Troubleshooting

"missing required module 'SwiftShims'"

If you renamed or moved the project directory, Swift's precompiled module cache retains stale paths:

cd apps/menu-bar
swift package clean
swift build -c release

AI Tools

Configure AI tools to work with the-brain

Contributing

How to contribute to the-brain

On this page

InstallationFeaturesLaunchAgentBuilding from SourceTroubleshooting"missing required module 'SwiftShims'"