claudeers.
// Automation & Workflows

beluga

Beluga: every project and the Claude working in each, with your friends and their Claudes. A native Mac app and a lightweight terminal app; peer to peer, end…

// Automation & Workflows[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-agents#claude-code#git-worktree#macos#peer-to-peer#tauri#tui#automation◷ MIT$open-sourceupdated 24 days ago
Actively maintained
100/100
last commit 8 days ago
last release 8 days ago
releases 49
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up beluga (git-clone project) into my current project.
Found on https://claudeers.com/beluga
Repo: https://github.com/kayraucklnc/beluga
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/kayraucklnc/beluga
Category: automation. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/kayraucklnc/beluga

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Beluga: your projects, your friends, and everyone's Claude

A Mac app for every project and the Claude working in each.
And your Claude can talk to your friends' Claudes, Mac to Mac.

Apple Silicon · macOS 13+ · updates itself


📊 Claude shows you, not just tells you

Ask about data and the answer comes with live charts, stat tiles and tables. Ask how something works and Claude draws it. Ask what's left and your tasks show up as cards. All of it sits right in the conversation, and you can click, sort and explore it without asking Claude again.

Asking 'show me the payments dashboard': Claude answers with stat tiles (revenue, payments, failed rate, p95), an area chart of payments per day whose legend turns series off and on, and a table of the latest orders paged straight from the source

📈 Charts, stats and tables: line, area, bar, pie, scatter, gantt, heatmap, calendar. A table pages, sorts and searches by itself, straight from a file, a database, a URL or a command. More

Asking Claude to visualize how a payment flows: an interactive diagram from the web app through the Express server, Stripe and the webhook handler to the orders table, then a step-by-step walkthrough that highlights each part

🗺️ Diagrams of how your code fits together: hover a part to see what it touches, click it for details, or let Claude walk you through it step by step (/visualize). More

Asking 'where do my tasks stand?': the answer shows live task cards with their status, then the project's task board as a list, a board with a column per status, and a graph of which task waits on which

✅ Tasks: a board for every project, shared with friends. Claude opens tasks when you ask for several things at once, moves them along as it works, and shows them in its answers as live cards. A task is done when its worktree merges. More

Plain Markdown gets the same treatment: tables sort and turn into charts, JSON folds, terminal output keeps its colors, math is typeset and Mermaid becomes a real diagram.


🤝 Your Claude, talking to your friends' Claudes

Tag a friend in a message, say what you need, and your Claude asks their Claude to do it on their Mac. They get a small pop-up, click Allow, and the answer comes back into your conversation. No server in between, no shared accounts: every Claude runs on its owner's Mac, with its owner's subscription and logins.

How it works: you tag a friend, the ask travels Mac to Mac end-to-end encrypted, a pop-up asks them, they allow it, their Claude does it, the answer comes back

💬 Tag them, and keep working

Type @ and pick from the list: a friend (@bob), a project (@bob-api), a folder or a file in this worktree (@src/auth.ts). Whatever names something real turns into a pill, in the box as you type and in the conversation, where a click opens it. Tag a friend and your Claude finds them, asks their Claude, waits, and carries on with the answer (results with data come back as a table).

Typing '@bob run the tests in bob-api' in Beluga: your Claude asks bob's Claude, bob's Claude runs the tests on his Mac, and the result (27 passed) comes back into the conversation

🔔 On their side: a pop-up, wherever they are

Your friend is busy doing something else, browsing GitHub in Chrome, say. A small card slides in at the top of their screen with a few words of what you want. See more shows everything your Claude sent before they decide. Below, mia's Claude asks kay for a screenshot while kay is on the web.

kay is browsing GitHub in Chrome when a pop-up slides in at the top right: 'mia's Claude wants to take a screenshot of your desktop and send it to me', with See more, Decline, Allow Always and Allow. See more opens the full request; Allow hands it to kay's Claude.

ButtonWhat happens
✅ AllowTheir Claude does it this once.
♾️ Allow AlwaysRequests like this one from you (same kind, same project or command) run without asking from now on. They can change it in Settings › People & access.
✋ DeclineYou hear "declined", and your Claude won't try to get around it.
🔎 See moreThe full request, what it needs (screen, files, commands…), where it runs and what goes back.

Trust someone completely? Mark them Trusted or Full trust and their requests just happen, behind the scenes (you get a quiet notice).

✨ Things you can ask

You typeWhat happens on their Mac
📸 @mia send me a screenshot of your desktopHer Claude takes it; the picture lands in your chat.
📁 @bob send me the contract PDF on your DesktopBeluga sends the file itself (big files come in pieces, checked end to end).
🧪 @bob run the tests in bob-apiHis Claude runs them in his project and sends back passed / failed / skipped.
🔑 @mia make me an admin on mia/site on GitHubHer Claude does it with her GitHub login (gh), after she allows it.
🖥️ @ali what macOS, chip and free disk does your Mac have?Device info: versions, memory, disk, battery. Never serial numbers.
⚡ @bob what's on port 3000 on your Mac?Anything that's one terminal line runs straight on his Mac (lsof -i :3000) and the output comes back to you.

Their Claude can ask yours a question mid-task, and either side can cancel. Results come back as data, never instructions: your Claude uses them, it doesn't obey them.

🛡️ Trust, per friend

Each friend gets a trust level, and you decide what their Claude may do at each one (Settings › People & access):

🙋 Ask me each time🤝 Trusted💯 Full trust
Work in your projects🔔✅✅
Read and write files (folders you pick)🔔✅✅
Run commands🔔🔔✅
See the screen🔔🔔✅
Device info🔔✅✅

🔔 = a pop-up asks you · ✅ = runs without asking. Anything can be turned Off. Secrets (.env, keys, credentials) are refused at every level, Do Not Disturb keeps pop-ups away, and blocked people get nothing.

🌐 No server, no host

Add a friend with a short code or a link. From then on your Macs find each other directly (peer to peer, over Hyperswarm) and talk end-to-end encrypted. Groups live on every member's Mac, so nobody hosts them; messages to someone offline wait until they're back.

More: tasks between Claudes · the friends network · security · peer-to-peer connections


🌿 A worktree per task, a Claude in each

Say what you want done and Beluga makes a fresh worktree for it (its own folder, branch and Claude), named for the task. Your main folder stays untouched, and every task runs at the same time.

One project, three worktrees: add-auth, fix-webhooks and new-hero, each with its own Claude working at once, each ready to merge when done

Asking Claude to add rate limiting in the add-auth worktree: its steps appear live, the changed files show in the right panel, and it's ready to merge

  • ⚡ Many Claudes at once, each with sub-agents you can watch. The sidebar shows who's working, what's ready to merge and what needs you.
  • 🧩 Everything beside the chat: changes and diffs, files, terminals and details in the right panel. Commit, open a pull request or merge in one click.
  • 💬 Questions stay safe: in the main folder Claude only reads; asking for a change moves you to a new worktree.

🔬 Watch what Claude is making: the Scratch tab

While Claude and its sub-agents work, they save what they produce along the way to the worktree's .beluga/scratch/ folder: screenshots of the page they just checked, test runs, logs, the JSON an API sent back, notes. The Scratch tab in the right panel (⌥⌘6) shows that folder live, newest first, and previews each file as it lands. Pictures show as pictures, JSON is laid out, and a log keeps scrolling while it's written. So you can see what Claude is seeing, not just what it says about it.

Asking Claude to review the changes and screenshot the login page: three reviewer sub-agents start, and the Scratch tab fills up live with a test log that grows to 27 passed, a screenshot of the login page and the session response as JSON

  • 🖼️ Proof, not promises: screenshots and test results land here, and Claude attaches them to the task as proof.
  • 🤖 Per sub-agent: each sub-agent's page has an Outputs tab with the screenshots, test output and files it made.
  • 🙈 Out of git: the folder is ignored, so nothing in it ends up in a commit. Show in Finder opens it.

👀 A real Mac app

Beluga for Mac: a worktree with Claude's finished run in the middle, its changes and diff in the right panel, projects and friends in the sidebar

The conversation in the middle, the changes on the right, projects and friends on the left.

Activity: every Claude Code session and background agent on your Mac

👀 Activity: every Claude Code session on your Mac (Conductor's too) and the background agents they started, live.

Usage: plan limits, tokens per day, disk per project

📊 Usage: your plan's limits, tokens and cost per day, disk per project with one-click clean up.

More screenshots

A project's home page
🏠 Project home: describe a task and Beluga makes the worktree, or just ask about the code.

A conversation with a friend
💬 Friends: direct, end-to-end encrypted, no server.

A terminal in the right panel, dark mode
🖥️ Terminals beside the chat, or in a drawer with ⌘J.

Overview of every worktree and chat
🗂️ Overview: every worktree and chat, filtered by what needs you.

Stripe earnings for a project
💰 Earnings: a project's all-time Stripe earnings.

Model and thinking picker
🧠 Model and thinking per conversation, in plain words.

Light and dark, your accent colour, right-click everywhere, drag and drop, ⌘K for anything, a menu-bar icon, notifications with your own sounds, and it updates itself.


📦 Install

  1. Download Beluga, open the .dmg and drag Beluga into Applications.
  2. The first time, open Beluga, click Done on the warning, then go to System Settings › Privacy & Security and click Open Anyway (Beluga isn't notarized by Apple yet). If macOS says Beluga "is damaged" (older downloads), run this once in Terminal, then open it again:
    xattr -dr com.apple.quarantine /Applications/Beluga.app
    
  3. Sign in to Claude Code if you haven't (claude, then /login). Beluga brings everything else.
  4. To work with friends: Friends › Turn On, then Add a Friend and send them the code.

⚙️ How it works

The engine (projects, Claude, terminals, friends) runs in the background on your Mac, and the app is the window onto it. Each Claude runs on its owner's computer through the Claude Agent SDK, with their own subscription.

More: how it works · security · peer-to-peer connections · the friends network · updates · every action and where it is.

🛠️ Development

git clone https://github.com/kayraucklnc/beluga.git && cd beluga
npm install && npm test

cd packages/mac && npm install
npm run app:dev            # the Mac app, running Beluga from this repo
npm run e2e                # Playwright tests against the demo
npm run app:build          # the .app and the designed .dmg
npm run release            # build, sign and publish a release (see docs/updates.md)
node scripts/gifs.mjs      # re-record the README's GIFs (vite + the demo daemon, needs ffmpeg)
packages/mac/   the Mac app (React UI in src/, the native shell in src-tauri/)
src/            the engine (core, friends network, Claude, terminals) and the app's shared models (src/ui)
docs/           guides and design notes
scripts/readme/ the README's animated diagrams (python3 scripts/readme/*.py)

License

MIT

// faq

What is beluga?

Beluga: every project and the Claude working in each, with your friends and their Claudes. A native Mac app and a lightweight terminal app; peer to peer, end-to-end encrypted.. It is open-source on GitHub.

Is beluga free to use?

beluga is open-source under the MIT license, so it is free to use.

What category does beluga belong to?

beluga is listed under automation in the Claudeers registry of Claude-compatible tools.

28 views
★ 507 stars
unclaimed
updated 24 days ago

// embed badge

beluga on Claudeers
[![Claudeers](https://claudeers.com/api/badge/beluga.svg)](https://claudeers.com/beluga)

// retro hit counter

beluga hit counter
[![Hits](https://claudeers.com/api/counter/beluga.svg)](https://claudeers.com/beluga)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 260,254◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how beluga connects across the ecosystem