# SharkBay – a local macOS workbench for coding-agent CLIs

> Source: <https://github.com/SharkUI/SharkBay>
> Published: 2026-05-29 07:00:42+00:00

**macOS workbench for multi-agent vibe coding**

Launch and manage multiple AI coding agents from one workspace.

Supported agents: **Claude Code** · **Codex** · **Gemini** · **Kiro** · **DeepSeek** · **Qwen** · **OpenCode**

Real-time status indicators from agent transcripts — see what each agent is working on without switching terminals.

Manage local projects in a unified sidebar. Add, remove, and switch between repositories instantly.

Project-local `.sharkbay`

harness with Markdown task records, synced through a GitHub remote branch. Works with any agent that reads files.

Task records provide shared context across agents and team members. Restore previous agent sessions from completed tasks with one click.

Embedded browser tabs for local dev servers and web URLs, right next to your terminals — no app-switching.

Auto-discovers `dev`

/ `dev:*`

scripts from `package.json`

and Python CLI web commands. Start and stop services without leaving the workbench.

Branch name, dirty state, changed files, and recent reflog activity — all visible in the project panel without running commands.

Built-in CodeMirror editor with syntax highlighting for 20+ languages. Open, edit, and save project files in tabs — Cmd+S to save, dirty state tracking, 5 MB file support.

Auto-generated HTML site from project docs and team task history — readable, browsable context for humans and agents alike.

[Product notes](/SharkUI/SharkBay/blob/main/docs/product.md)[Architecture](/SharkUI/SharkBay/blob/main/docs/architecture.md)[Development guide](/SharkUI/SharkBay/blob/main/docs/development.md)[Testing](/SharkUI/SharkBay/blob/main/docs/testing.md)[Release and packaging](/SharkUI/SharkBay/blob/main/docs/release.md)[Task Protocol](/SharkUI/SharkBay/blob/main/docs/tasks.md)[Agent guide](/SharkUI/SharkBay/blob/main/docs/agents.md)[Roadmap](/SharkUI/SharkBay/blob/main/docs/roadmap.md)

Electron · React · TypeScript · Vite · xterm · @lydell/node-pty · CodeMirror

- macOS
- Node.js >= 20.11
- Git
`gh`

CLI (only for team context sync)

```
npm install
npm run dev
npm run typecheck
npm test
npm run build
npm run pack    # unpacked app for smoke testing
npm run dist    # distributable macOS artifacts in release/
```

SharkBay is licensed under the GNU General Public License v3.0 only. See [LICENSE](/SharkUI/SharkBay/blob/main/LICENSE).