Web bees and AI bees

Jump to: Web bees · AI bees

Web bees

Google for quick searches, your Home Assistant dashboard, a status page: anything with a web address. Each Web bee counts as one of your bees, like any other.

Add one (about 1 minute)

1. Click the hexagon in the menu bar → Add a Bee → Web.
2. Type a name (such as “Home”) and the Home address, for example google.com, https://example.com or homeassistant.local:8123. Waggle adds https:// for you, or http:// for addresses on your local network.
3. Click Add Bee.

What success looks like: a new bee appears and opens at its home page. Once the page has loaded, the bee shows the site’s icon (or a globe).

On macOS 15 or later, the first time a Web bee opens a page on your local network, macOS asks whether Waggle may find devices on your local network. Click Allow.

Use it

• The bar at the top has Back (⌘[), Forward (⌘]), Reload (⌘R), Home, the address (⌘L) and Open in default browser.
• Mobile or desktop site: Web bees ask for each site’s mobile version, which suits a small window. Click the computer button in the bar (or right-click the bee → Show Desktop Site) for the full site. Click the phone to go back.
• Zoom: ⌘+ to zoom in, ⌘− to zoom out, ⌘0 for actual size.
• Sign in to sites inside the bee as you would in a browser. Each Web bee keeps its own sign-ins on this Mac; they never sync. To sign out of everything: right-click the bee → Clear Cookies & Sign-ins…
• Change the home address: right-click the bee → Edit Home Address…, or Settings → Bees.
• Downloads go to your Downloads folder. The first time, macOS may ask whether Waggle can access it: click Allow.

Google doesn’t allow signing in to a Google account inside apps’ built-in browsers. Searching works without signing in. If Google refuses, the bee says “Google won’t sign in here”: use Open in Default Browser.

AI bees

Claude, ChatGPT, Grok and Gemini bees are floating chats, with projects, a choice of model and replies that stream in as they’re written. Each uses an API key from that company, billed to your API account, separately from any subscription. Your chats on claude.ai, chatgpt.com, grok.com or gemini.google.com don’t appear in the bee.

Add one (about 2 minutes)

1. Click the hexagon in the menu bar → Add a Bee → Claude, ChatGPT, Grok or Gemini.
2. Click the Open … button in the bee for that company’s site. Sign in, make a key and copy it. It’s only shown once.
3. Paste it into the bee and click Connect.

What success looks like: the bee says Connected, and the pencil button offers New Chat, Projects… and Model.

The key stays in this Mac’s Keychain and never syncs. Your projects and model choice sync with Settings sync; chats stay on the Mac you had them on.

Use it

• New chat: pencil button → New Chat. Chats are named after your first message; right-click one to rename, archive or delete it.
• Projects: pencil button → Projects… Instructions and reference files that every chat in the project gets. To bring a project across from the company’s own app, copy its instructions and download its files there, then make a project with them here.
• Model: pencil button → Model.
• The stop button ends a reply early. You can send pictures and text files too; Claude and ChatGPT also read PDFs.

Using Gemini at work? A Google Workspace Gemini subscription doesn’t cover the Gemini API that other apps use. Use a key from a personal Google account, or ask IT for an approved key.

If something’s not right

• Why won’t Google let me sign in?
• Why does a page say “This page isn’t secure”?
• What doesn’t work in a Web bee?
• Can an AI bee see my chats on claude.ai or chatgpt.com?
• How does the Gemini bee work?
• Which files can AI bees read?
• A reply failed. What now?

Next: Arrange your hive