beluga

What it does

• Work on everything at once: every task gets its own worktree, branch and agent, and they all run side by side.
• See every agent work: steps, sub-agents and screenshots arrive live, and you can steer mid-run.
• Answers you can see: live tables, charts, diagrams and task cards right in the conversation.
• Your agent, and your friends' agents: tag a friend and your agent asks theirs to do it on their Mac, after they click Allow.
• Sentinel: work you describe once runs on a schedule or when something happens, and leaves a report.
• Run it on a server: put it on a computer that stays on, then use it from your phone or any browser.

Install

1. Download Beluga for your computer.
2. Open it:
   • Mac: open the .dmg and drag Beluga into Applications. The first time you open it, macOS blocks it because Beluga isn't notarized by Apple yet: click Done, then go to System Settings › Privacy & Security and click Open Anyway. If macOS says Beluga "is damaged" (older downloads), run this once in Terminal and open it again:

     xattr -dr com.apple.quarantine /Applications/Beluga.app
     

   • Windows: run Beluga_…_x64-setup.exe. If Windows says it protected your PC, click More info › Run anyway (the installer isn't signed yet). Install Git for Windows too; Claude Code needs it.
   • Linux: make the .AppImage executable and open it (it updates itself), or install the .deb / .rpm.
3. Sign in to Claude Code (claude, then /login) if you haven't. Beluga brings everything else.
4. To work with friends: Friends › Turn On, then Add a Friend and send them the code.

Work on everything at once

Describe a task and Beluga makes a fresh worktree for it: its own folder, branch and agent, named for the task. Your main folder stays untouched (there, your agent only reads), and every task runs at the same time, in one repository or across all of them.

See every agent work

Steps arrive as your agent works: the files it reads, the commands it runs, the sub-agents and background tasks it starts. Say something mid-run and it changes course.

The Scratch tab shows what your agent makes along the way (screenshots of the page it just checked, test runs, logs, the JSON an API sent back) as each file lands, so you see what your agent sees, not just what it says about it. Your agent attaches the best of it to the task as proof.

Answers you can see

Ask about your data and your agent finds the database, connects and runs the query; the answer is a live table you can sort, search and turn into a chart. Ask how something works and it draws a diagram. Ask what is left and your tasks show up as cards. You explore all of it without asking again.

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

Your agent, and your friends' agents