Repository navigation
Releases
Beluga 3.6.1
Beluga 3.6.1: Full Autopilot, a planner, builder and checker for each plan, questions that wait for you, and Push main to origin.
- Full Autopilot: turn it on for a chat (the composer's mode menu) or a plan (Autopilot › Never wait for me), and a stand-in agent answers whatever your own agents would ask you: questions, plans to approve, a plan's decisions and your own runs' approvals. A quiet line in the chat says what it chose and why. Secrets, friends' requests and tasks only you can do always stay yours.
- Who plans, builds and checks: a plan has a planner, a builder and a checker, each any agent and model. New Plan says it as one sentence, and Mix Agents gives each part its own picker.
- Questions wait for you: your own agent's questions and plans no longer get skipped after 5 minutes. Only work on Autopilot gives up, after the wait you pick in Settings › Agent › Autopilot (5 minutes to 4 hours, or until you answer).
- Push main to origin: after Straight to main, a worktree whose work is all on main shows how many commits aren't pushed, with Push main to origin as its main step. It fetches first and never forces.
- Delete several at once: in the Overview, ⌘-click, Shift-click or ⌘A to pick worktrees and chats, then delete them with one question.
- Long pastes as a file: a paste of 6,000+ characters or 120+ lines goes as a text file chip, and the agent gets its first lines and the file.
- OpenCode, Codex and Copilot from npm: Beluga finds them installed with npm under nvm, fnm, Volta or pnpm too.
- Chinese: 373 more Mac strings in 简体中文, and Enter that picks an input method's words never sends the message.
- Computers on different versions: a paired computer on an older or newer Beluga no longer crashes the window or shows as offline.
- Onboarding: a tour you can play with.
- Fixes: Archive Instead in the delete dialog archives again; a picture you send sits on the right; Copy Image works again; chats drag onto each other with sidebar categories on; the home box's Name and Then no longer overlap; git's messages are read right on a Mac in another language; the board reads the words agents explain a criterion with.
The phone app is 3.6.1 too, with Full Autopilot, a plan's three parts and Push main to origin, and it updates by itself.
The Android app (Beluga-3.6.1.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.6.0
Beluga 3.6: Straight to main for small changes, every monospace font in the terminal, Codex from mise or asdf, and keys caught in more shapes.
- Straight to main: a new worktree can land on main instead of its own branch. Pick Then › Straight to main in the new-worktree box and the agent still works in a worktree of its own, but when each turn ends Beluga commits, rebases and fast-forwards the main folder. No branch, no PR, nothing pushed, and your own uncommitted changes in the main folder are never touched. Any worktree with work and no PR can switch to it from its branch menu, and the phone gets the same steps.
- Every monospace font: Settings › Terminal › Font lists every monospace font installed on this computer, not just twelve names, and a font you install shows up without a restart.
- Codex from mise or asdf: Beluga finds a Codex installed through mise or asdf (and in Homebrew's folders and
~/.local/bin), and starts the real Codex behind a mise shim. - Keys in more shapes: pasting a custom API key that doesn't match a known pattern gets a softer offer to keep it as a key, and any word you pick can be kept as one.
- Usage statistics, split in two: the middle level is now called Essential and sends only which features you use and Beluga's own tool calls, with no agent sessions. Whole sessions go only at On. Your saved choice stays as it was.
- Calmer Usage page: a quieter pass hero, and titles as a plain list.
- Fixes: a long menu stays below the title bar and its rows line up; a project opened from Settings › Environment comes up above Settings; a key chip in the message box ends where its words end.
The phone app is 3.6.0 too, with Straight to main's steps and the Essential level, and it updates by itself.
The Android app (Beluga-3.6.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.5.0
Beluga 3.5: pasted API keys stay out of the chat, Run on a command Claude gives you, chat schedules, and a terminal that stays smooth under a flood.
- Pasted API keys stay safe: paste a key and a card offers to keep it as the chat's own variable. The key leaves the message, a key chip takes its place, and Claude gets it in its environment by name. The box's Keys pill lists a chat's keys, and Merge asks whether the project keeps them.
- Run a command from the chat: a shell block in your messages or Claude's gets Run beside Copy. It types the command into the terminal and puts the keyboard there. Untagged blocks of commands to paste get it too.
- Chat schedules: wake your own chat daily, once in a few hours, or after a usage limit lifts, from /schedule or the chat's Info panel. They run on Sentinel, and the phone can run or pause them.
- Share with "Can take it over": handing off is now part of Share, and any share can come with a handoff note your agent writes (goal, where it stands, next steps).
- Smooth terminal: every terminal draws with WebGL, and a program flooding output waits for the screen to catch up, so typing and Ctrl+C answer at once (21 ms, down from 7 s).
- zsh takes the bash agents write: an unmatched glob, a URL with
?or[ a == b ]no longer fails a whole command in zsh. - Format any file with Beluga's own Prettier when a project has none.
- Fixes: an approval shows only in the chat that asked, and other chats point to it; a merge with open criteria leaves its task In Review instead of Done; images in your answers to an agent's questions reach it; pasted images nothing links to any more are cleaned up; a folder link outside your projects opens in Finder; a chat shows as working while a thread under it runs; Codex asks Beluga's permission gate for Beluga's tools, as Claude does; menus close for good on Windows; Windows and Linux say "this computer", not "this Mac"; the home page holds its shape in a narrow window; a worktree's setup shows one short toast when it's done.
The phone app is 3.5.0 too, with chat schedules, and it updates by itself.
The Android app (Beluga-3.5.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.4.0
Beluga 3.4: no more freezes when a team's board loops, MCP Apps in the chat, share a plain chat with a friend, and a model picker you can search.
- No more freezes on a busy team: one task's activity line could go round a team's Macs forever, freezing Beluga for 10 seconds or more at a time, so a new worktree took minutes to open. A line taken back now stays gone everywhere, a task that loops is held and sent once, and the board opens in about 55 ms. Everyone on the team should update: an older Mac keeps passing the line on to the others.
- MCP Apps: a server's app shows under Claude's card in the Mac chat, and anything it does goes through Beluga's trust rules. The phone says which app is open on your Mac.
- Share a plain chat with a friend, one chat at a time, from its Share this chat menu.
- Model picker: search a long list, models grouped by provider, and DeepSeek and Kimi added. With a local or bring-your-own model, your Claude sign-in never reaches that endpoint, and DeepSeek picks up a resumed run.
- New worktrees: your message shows in the chat at once, then Claude starting, and the worktree's
.env.examplecatches up with its.envnames (placeholders only). - Plans: a task that needs you asks with a card, and a stopped one says what it needs, on the phone too. The conversation you plan in runs on the agent picked for the plan's work.
- Fixes: a friend's call rings through even while their Mac is busy; a worktree shared on its own stays on its own, and shared worktrees show a green dot; a fork's PR worktree no longer reads as "commits not on PR" after
git pull; the Delete dialog lets you choose after 10 s instead of staying greyed out; a computer added over SSH doesn't leave ssh running after Beluga quits; Autopilot asks you instead of passing a milestone whose merge failed; a path Claude writes from.beluga/(scratch, reports) opens when clicked; a friend's Claude never gets the daemon's environment, and a directory search can't open a credential file; chat links are on for everyone; Chinese for what 3.3 added.
The phone app is 3.4.0 too, with the searchable model picker, and it updates by itself.
The Android app (Beluga-3.4.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.3.0
Beluga 3.3: Claude signs in to your MCP servers from the chat, Claude in Chrome in every run, one Project Settings sheet, and draft pull requests when a task reaches In Review.
- MCP sign-in from the chat: when a server needs OAuth (Datadog, Vercel and the like), Claude opens its sign-in page in your browser and its tools load in the same turn. No more
/mcpin a terminal. - Claude in Chrome in every run: Claude can use your browser in any chat, and asks you first unless you asked for it.
- Project Settings: a gear on the project page (or ••• › Project Settings…) opens one sheet for the project. Worktrees get their own variables, and
.env.exampleis kept in step. - Draft pull requests: when a worktree's task reaches In Review, Beluga opens a draft PR for it. Merge Now, Skipping Checks also stops the checks still running.
- Sentinels run every minute or every 5, 10, 15 or 30 minutes, on the clock, and a PDF in a kept table opens with its pages, in a sheet tall enough to read.
- Background fetch, your way: Settings › Workspaces › Fetch in the background picks every 5, 15 or 30 minutes, every hour, every 4 hours, or Never.
- Settled chats archive by themselves after 14 days. Change the number of days, or turn it off with 0, in Settings › Appearance.
- Sidebar: colour projects and chats (opt-in), and with the categories on, chat rows can be renamed, retitled and Shift+clicked, the bulk menu has the inbox actions, and settled rows have Archive.
- In the chat: selecting text pops up Copy and Ask beside it; Claude's newest in-between words stay in sight while it works and fold away with its answer; sending no longer blanks the chat; tab titles show a named chat by its title.
- Usage statistics: a new, opt-in choice (Off, Limited or On, on the Mac and the phone). Off sends nothing.
- Agents start a task's worktree from any conversation, and editing a sentinel keeps it on.
- Fixes: a fork shows at once and carries the whole worktree, and a worktree being made shows where it will land; the caller hears the ringback again; call pointers fold away when idle; right-click menus close on any outside press, one at a time; pop-up Later never opens Beluga; opening a content search hit no longer shifts the window; What Waits on What stays smooth on a real-sized board; a plan gate's "Checked · pass it" passes the milestone.
The phone app is 3.3.0 too, with Usage statistics in its Settings, and it updates by itself.
The Android app (Beluga-3.3.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.2.0
Beluga 3.2: a leaderboard with your friends, who's on a board, Clone from your GitHub repos, and previews of React Native components.
- Leaderboard: Usage has a scoreboard with your friends, and it holds up when you have many of them.
- Who's on a board: a board shows its people beside Active and Backlog, with Add Friend right there.
- Clone from your GitHub repos: Clone lists your own repos to pick from, instead of asking for an address.
- Live previews draw React Native components, built as their web build would be, and Tailwind 4.1 projects preview again. A Tailwind that won't load says so.
- Asking for a star, once: Beluga no longer asks for a coffee. It asks for a GitHub star only at your third merged pull request, in a new sheet with a Share feedback button.
- The branch pill sits beside the worktree's name, and is smaller.
- Beluga's new home: the app, the updater and the phone now point at github.com/beluga-labs/beluga.
- Fixes: fetch and push work with friends who only have SSH, and on the Linux AppImage; Settings' MCP check uses the variables you saved in Settings › Environment, as real runs do, for Claude and Codex; a worktree no longer gets named after an expired sign-in error; Usage's card drops in smoothly on slower GPUs; stats count merged pull requests again; a pasted worktree chip is one piece in the message box and as wide as its name; a deleted image in an answer shows a placeholder instead of an error; a part of the window that fails says why instead of turning grey; on Linux, no GTK shortcut warnings, sound in the AppImage, and pairing says why it failed; restricted Codex sessions on Linux run again.
The phone app is 3.2.0 too, and it updates by itself, now from Beluga's new home on GitHub.
The Android app (Beluga-3.2.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.1.0
Beluga 3.1: agents from outside Beluga, GitHub Copilot, comments on a diff's lines, and Beluga in Simplified Chinese.
- External agents: a Claude Code or Codex in your own terminal, a local model, or a hosted agent can drive Beluga through one MCP server. Turn it on in Settings › External agents, give each agent a pairing code, and it makes ordinary Beluga chats with your own logins. Each agent has its own grant and its own name on what it does; a card asks you for anything that needs a person, and you can stop or revoke any grant on its own. The phone shows what they did and can stop them too.
- GitHub Copilot is an agent you can pick, with Copilot Free on Auto. The agent picker is more compact: agents down a rail, one line per model, and thinking effort as one sliding track from Auto to Max. Claude Code keeps itself current, so new Claude models show up without a Beluga update.
- Comment on a diff's lines: select lines in a diff and write a comment. Comments wait above the message box as cards and go to the chat together.
- Worktree links: copy a worktree's link and paste it in another chat, where it becomes a chip, on the Mac and on the phone.
- Simplified Chinese: Settings › General › Language offers Follow System, English and 简体中文.
- Clone a project from its git address when you add one, and Fork to My Mac gets the project onto this Mac first instead of stopping.
- Earnings from RevenueCat, next to Stripe's: MRR, subscriptions, trials and new customers for apps sold through the App Store and Play Store.
- Shared worktrees: a guest's @claude in a shared worktree is their own agent, and in a friend's worktree @claude says it asks their agent.
- The room's Chat is no longer a place of its own: while someone else is in the room, its group chat is the first channel, and the window opens on Overview.
- Fixes: friends hear each other in calls again; Ctrl+V pastes on every keyboard layout, and Add projects shows what it did; Quit always ends Beluga, and on Windows it no longer reopens after installing an update; issues and PR comments written in HTML read as GitHub draws them; long titles no longer clip the toolbar's actions; a live preview that can't draw says so in a short note; Copy Image in Share Your Stats works; the Usage pass swings out without being cut off, and stats no longer say "Since Jan 1970"; on Windows, Codex worktree sessions run in its unelevated sandbox.
The phone app is 3.1.0 too, and it updates by itself. It lists your external agents and stops them, shows GitHub Copilot's mark, and draws worktree links as chips.
The Android app (Beluga-3.1.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 3.0.0
Beluga 3.0: your work on any computer you own, a sidebar that knows what needs you, and steering you can take back.
- Your computers: pair a Mac mini, a cloud server or a Linux box in Settings › Your Computers, over SSH or with a one-time code, and your work runs there while the app stays on the Mac in front of you. Pick it per task with Runs on beside the mode and model, or send all new work there; Best Available picks the computer with the most room. One sidebar and one Needs You cover every computer. Get Ready clones a project a computer doesn't have and installs its tools after you say yes. Files, diffs and search feel local, a dev server there opens at the same
localhostport here, and.envfiles only go after an ask that names them. Your settings follow you, Continue On and Move To carry work between computers, and one computer can be Always On for you on the network. Your phone reaches every computer directly, also with your Mac asleep. Each computer shows its own mark: its cloud, its distribution or its Mac model. - The sidebar sorts chats into Inbox, Working, Later and Settled (turn it on in Settings). A merged PR settles its chat, and Remind Me Later quiets a chat until it's due. A search field at the top finds chats by title, branch or PR, then messages (⌥⌘F). Shift-click selects a range of chats to archive or delete at once.
- Back and Forward in the toolbar, with ⌘[ and ⌘], and the mouse's buttons. Each page comes back with the panels it had open.
- Steering: a steer goes in at Claude's next step and never stops the turn. A second steer joins the first. Cancel takes an unread steer back into the box, and a steered message reads as read the moment Claude takes it in. Settings picks whether sending during a turn queues or steers.
- Usage limits: a run stopped by your plan's limit continues on its own a minute after the limit resets. The card says when, with Continue Now and Don't Send.
- Pull requests: the toolbar names the real next step (Push N Commits, Resolve Conflicts, Checks running, Re-run Failed Checks). Merge pushes what the PR is missing first and never merges without it, and agents keep an open PR current. A merge shows as a line in the worktree's chat. A new Pull Requests page under Work lists every open PR.
- Plans: verifying a plan shows its four checks as they run, its latest line, and Watch It Work. Plans have no milestone limit, Plan with Tasks is back on a new worktree, and a plan waiting for review takes Send Changes.
- Usage stats: a roomy dashboard of your stats by project and agent, with the week's chart, your card and a recap.
- Chats: Claude's in-between words read quiet, and only its answer stands out. Regenerate Title writes a fresh title from what the chat is about now. Files and folders named in chat are links, also in backticks, and right-click shows them in Finder. A re-taken screenshot shows its new picture, and files you send your agent land in the Scratch tab's own Sent section.
- Dictation: pick which microphone it listens to.
- Experimental (new in Settings, off by default): Live previews draw a component your agent built right in its answer, with a control for each prop. Sub-agent threads let an agent start child threads and bring their results back together.
- Fixes: views that stall while loading offer Reload instead of staying blank; Delete no longer warns about a squash-merged branch's commits; the running step stays readable under Reduce motion; picking the login shell in Settings › Terminal sticks; on Windows, Open in File Explorer shows its window and Size on disk finishes measuring.
The phone app is 3.0.0 too, and it updates by itself. It shows every computer you paired and starts work there, sorts its Work tab like the sidebar, cancels a steer, says when a limited run continues, and shows a plan's checks as they run.
The Android app (Beluga-3.0.0.apk) and Beluga Link (Beluga-Link.apk) are attached.
Beluga 2.3.2
Beluga 2.3.2: clearer calls and a call card that stays out of the way.
- Noise removal is on in every call, so background noise stops reaching the others. Turn it off for one call from the microphone menu.
- The call card shrinks to the faces in the call and grows back when you point at it, with Stop, Mute, Leave and Hide. Whoever is talking slides to the front with a green ring, and the card turns soft rose while you're muted. Its buttons work on the first click, you can drag it anywhere, and it comes back to the same place after a restart. Hide works in any call.
- Screen sharing: the person sharing sees everyone's pointers and drawings again, also when sharing a single window. Viewers pick Sharp or Smooth from the ••• on the stage.
- Fixes: beside a shared screen, Send stays inside the composer. On a server, Ctrl+C the moment
beluga setupasks Pair? now stops setup and closes the pairing, instead of quitting without a word.
The phone app hasn't changed: it stays 2.3.0.
Beluga 2.3.1
Beluga 2.3.1: better calls, forks, and finding a setting.
- Calls: the caller hears a ringback until someone joins, and a call that would reach nobody doesn't start (the Call button says why). A ring nobody answers leaves "tried calling you" in the conversation and the inbox, with Call Back. Pick your microphone and speaker beside Mute.
- Screen sharing: Show My Pointer puts an arrow in your colour, with your picture and name, on the share. Sketches fade after a few seconds, there's a Box tool (or Shift-drag), and Ask sends the part you marked.
- Call notes keep one language for the whole call, start once someone else has joined, and are written by the best model in the call; the Notes button says which.
- Settings has a search field: type "dark mode" or "font size" and it takes you to the row. ⌘F comes back to it.
- Forks: pull requests open and merge on your fork, not the original. Sync Fork on the project home brings in the original, and Create PR on sends a worktree's branch upstream.
- Rename a worktree from the sidebar, and its branch follows.
- The Changes tab can group its files by folder.
- Beluga in a browser has a gear in the sidebar with Settings and the menu bar.
- Emoji reactions stay in group chats; conversations with Claude no longer have them.
- Fixes: deleting or archiving a worktree stops the Claude working in it; /btw never leaves a blank card; a friend's task steps no longer look like they open; a picture in the chat is one card.
The phone app hasn't changed: it stays 2.3.0.