open-source macOS workbench for multi-agent coding

SharkBayMulti-agent coding workbench for macOS

Launch Claude Code, Codex, Gemini, Kiro, Qwen, OpenCode, and other coding agents from one local project workspace. SharkBay is GPLv3 open source, leaves your agent instructions intact, keeps teamwork context in Git, and turns finished artifacts into shareable snapshots when you choose to publish them.

Built for the agent CLIs developers already use.

Launch and watch supported coding agents from the same project workspace.

Built around your existing development rules.

01

Open source first.

The desktop app, releases, issues, and GPLv3 license all live on GitHub. Developers can inspect how SharkBay launches agents, tracks status, stores task records, and syncs context before putting it in their workflow.

02

Your agent setup stays yours.

SharkBay works alongside project instruction files such as AGENTS.md and CLAUDE.md instead of editing them. It keeps status hooks limited to visibility: they report what the agent is doing so SharkBay can show working, approval, and stopped states without replacing your existing agent habits.

03

No login wall or SharkBay cloud dependency.

Teamwork context is stored through Git, including the sharkbay-team-context branch, and authentication follows the developer's existing GitHub and gh command setup. The goal is low coupling: your repositories, identity, and collaboration history remain portable outside SharkBay.

Designed around real local projects.

Add the repositories you care about, launch agents in project context, run dev services, review task records, generate artifacts, share finished snapshots, sync teamwork context, and keep browser tabs attached to the same workspace.

1

Add your projects

Register exact local directories and switch between them from the sidebar.

2

Launch agent sessions

Open supported coding agents in visible project terminal tabs.

3

Watch status and services

Track agent state, terminal activity, dev commands, browser tabs, and Git changes.

4

Leave durable context

Use task records so another agent or teammate can understand what changed and how it was checked.

Task context that lives with the repo.

SharkBay Task Protocol writes concise Markdown records under each project. Agents can read the same scope, files, work notes, and verification history without depending on a private chat transcript.

SharkBay task detail view showing protocol summary and metadata

Multi-agent launcher

The first advantage is not "we support many CLIs" in the abstract. SharkBay turns those CLIs into visible project tools: pick a repo, start the right agent, and keep the session attached to that workspace.

SharkBay / sharkbay.xyz 8 agent CLIs
sharkbay.xyzCodex working
SharkBayClaude idle
api-server2 services
$ codex "refine the homepage mockup"
project: /Projects/sharkbay.xyz
context: task M3K8VQ, dirty files visible

Agent is working in the same repo you selected.
Type here... Enter to send, Shift+Enter for newline
SessionsTasksGitFiles
Knowledge Site Browse project docs and team task history as a local site.
Homepage mockup rewrite M3K8VQ · SharkUI · active
Review homepage sections Claude Code · restore session

Live agent status

Multi-agent work breaks down when every terminal looks equally alive. SharkBay makes agent state a first-class signal, so users know where attention is needed before opening a tab.

SharkBay workspace project status
sharkbay.xyz /Users/shark/Projects/sharkbay.xyz
$ codex "continue homepage mockup"
project: /Users/shark/Projects/sharkbay.xyz
tab: Codex CLI

Editing docs/mockup/index.html and keeping the project card updated.
Type here... Enter to send, Shift+Enter for newline

Island overlay

The island is the "ambient awareness" feature. It is not another dashboard; it keeps long-running agent work visible while the developer is in a browser, editor, or terminal elsewhere.

SharkBay Island overlay attached to the top of the Mac screen

Teamwork context

SharkBay's collaboration story is deliberately Git based. Context is not trapped in one agent's chat window or a SharkBay account; it becomes task records and team memory that move through the repository's context branch.

SharkBay Tasks view showing team task context and restored sessions

Task Protocol

The protocol gives agent work a durable shape: scope, files, work notes, verification, and commits. It is lightweight enough for local development, but structured enough for handoff.

.sharkbay/tasks/... task.md
## Summary
Implemented the homepage mockup for review.

## Files
- docs/mockup/index.html

## Work
- Built a static SEO-friendly page structure.
- Linked product actions back to GitHub.

## Verification
- Opened the local mockup in a browser.
- Checked responsive layout and links.

Review sessions

Review is a separate mode, not just another agent prompt. SharkBay starts a constrained session that reads task context and writes a local report instead of making changes.

Read-only by designReview sessions inspect task context and write reports without changing project files.
Local report outputFindings live in the repo so follow-up agents can read the same evidence.

Embedded browser

When the task is visual or web-facing, the browser belongs next to the terminal. SharkBay makes local preview and agent output part of the same project surface.

Preview stays with the projectLocalhost pages, docs, and artifacts remain attached to the selected workspace.
Useful for visual workAgents can verify UI changes without leaving the SharkBay workbench context.

Artifacts

Some agent work is meant to be opened, inspected, and handed off: mockups, reports, docs, and single-page tools. SharkBay gives agents a scoped Artifact output path so the finished result stays tied to the task that produced it.

Scoped outputArtifacts are written under the project workspace instead of disappearing into chat history.
Preview-readyOpen generated HTML beside the terminal and verify it in the same SharkBay context.

Share

When an Artifact is ready to leave the local machine, SharkBay can publish it as an unlisted share link. The snapshot shows the output without exposing the repository, task records, or local workspace.

Snapshot, not repo accessThe share service stores the rendered artifact and audit metadata, not your project files.
Useful handoffSend a finished mockup, report, or mini tool to someone who should review the result.

Dev service launcher

SharkBay treats dev servers as project state, not random background commands. The user sees which service is running and can get back to its logs quickly.

Services are visible stateRunning dev commands are shown as part of the project, not hidden shell history.
Logs remain reachableJump back to the right service output when a browser preview or agent needs it.

Git awareness

Agent work should never feel detached from Git state. SharkBay puts branch, dirty files, and recent activity in view before the user commits to a direction.

Branch and dirty state stay visibleUsers can see whether agent work is clean, partial, or ready for review.
Local Git remains the source of truthSharkBay reads and surfaces repository state without taking over the workflow.

Files and quick editor

Sometimes the right move is a small edit beside the terminal. SharkBay gives users enough file access to inspect and patch context without becoming a full IDE.

Inspect nearby filesOpen task records, docs, and source files without changing tools for a small check.
Patch context when neededKeep lightweight edits close to the terminal session that motivated them.

Sessions and recovery

Long-running agent work often spans interruptions. SharkBay keeps sessions visible enough that users can identify, restore, and continue the right thread.

Resume the right threadSession entries preserve the agent, project path, and recent activity.
Reduce context lossInterrupted work can continue from the same local workspace instead of a blank terminal.

Open-source foundation

The website should make the trust model obvious: SharkBay is open-source desktop software, not a hidden cloud workspace. It coordinates local agents while keeping project instructions and login outside SharkBay's ownership.

GPLv3 sourceSource, releases, issues, and license details stay on GitHub.
Local-first trust modelProject instructions, Git identity, and agent accounts remain under the developer's control.

Remote control

Agent sessions keep running after you step away from the Mac. SharkBay can pair with your own self-hosted Telegram bot, so you can check in, steer agents, and clear approvals from your phone.

Operate sessions from TelegramAdd a BotFather token and pair your account, then attach to an open session, resume a past one, start a fresh project and agent, or read the session's task records.
Live progress and inline approvalsFollow replies with a typing indicator, approve actions with inline buttons, and read answers and task docs rendered as clean Telegram markdown.

Find in tabs

Long agent output and busy web previews are easier to navigate when you can search them in place.

Search inside any tabPress Cmd+F to find text within terminal and browser tabs, with a popover showing match count and navigation.
Per-tab search stateEach tab keeps its own matches so you can move between sessions without losing your place.

Install the open-source SharkBay app from GitHub.

The public site keeps the product story simple. Downloads, source code, release notes, issues, and GPLv3 license details stay on GitHub where developers already work.