SharkSpace for MAC
Free Mac app that groups project folders into virtual workspaces for Codex, Claude Code and the terminal, and lists your Codex sessions per workspace.
SharkSpace Overview
SharkSpace, also called Shark, is a free virtual workspace manager for Mac. It creates a real folder for each workspace and mounts your project and component folders inside it with symbolic links, so Codex, Claude Code, Cursor, the terminal and other agent tools can open the whole workspace like an ordinary project. The window shows your workspaces in a sidebar, the folders of the selected workspace with their Git branch, latest tag and sync status, and the Codex sessions that belong to it.
SharkSpace is made by the developer SSBun, who publishes the source code on GitHub; the repository has no licence file, and its documentation is written in Chinese. All data stays on your Mac: workspace details are saved in a .shark-workspace.json file, with no data collection and no cloud sync. Version 1.15.0 is an Apple Silicon build that needs macOS 15.2 or later. It is ad-hoc signed and not notarized by Apple, so macOS may block it or call it damaged on first launch; the developer gives the command xattr -rd com.apple.quarantine /Applications/SharkSpace.app. From this version the app updates itself through Sparkle, a feature the developer still marks as in development.
Key Features
SharkSpace keeps multi-repository work and agent sessions in one place.
- Virtual folder workspaces: a real folder with symbolic links to several project folders.
- Projects: add an existing folder directly, without creating a virtual workspace.
- Git overview: branch, latest tag, uncommitted changes and upstream status for every repository.
- Codex sessions: see the sessions of each workspace, grouped by recent activity.
- Session actions: resume in the terminal, archive, delete, preview or copy a session ID.
- iTerm jump: with Codex hooks installed, jump to a running iTerm2 session.
- Health check: find missing folders and broken symbolic links and rebuild them.
- Local-first: workspace data stays on your Mac with no cloud sync.
What’s New in Version 1.15.0
SharkSpace 1.15.0 adds automatic updates through Sparkle.
- Sparkle 2 updater, with Check for Updates in the app menu and in Settings
- Later updates are checked over HTTPS with EdDSA signatures
- Packaging keeps framework symbolic links and verifies the code signature before and after copying
SharkSpace FAQ
Is SharkSpace free?
Yes. SharkSpace is free to download from its GitHub releases page. The source code is public on GitHub, but the repository has no licence file.
What is a virtual workspace in SharkSpace?
It is a real folder that contains symbolic links to several project or component folders. Because it is an ordinary folder, Codex, Claude Code, Cursor and the terminal can open it without knowing anything about SharkSpace.
Which macOS version does SharkSpace need?
SharkSpace 1.15.0 needs macOS 15.2 or later and a terminal app to open workspaces in.
Does SharkSpace run on Intel Macs?
The 1.15.0 release is an Apple Silicon (arm64) build. The developer does not offer an Intel build of this version.
Why does macOS say SharkSpace is damaged?
The app is ad-hoc signed and not notarized by Apple. The developer says to run xattr -rd com.apple.quarantine /Applications/SharkSpace.app in Terminal after moving the app to Applications.
Does SharkSpace show Codex sessions?
Yes. Under each workspace it lists the related Codex sessions, grouped into the last 8 hours, last 2 days, last week and older, with archived sessions folded away.
Can SharkSpace show Git status?
Yes. The folder list and the workspace Git overview show each repository's branch, latest tag, uncommitted changes and upstream sync status.
Does SharkSpace upload my data?
No. The developer says all data is stored on your Mac, with no data collection and no cloud sync.
Does SharkSpace update itself?
From version 1.15.0 it includes the Sparkle 2 updater. Version 1.14.0 did not, so users of that version need to download the new DMG once by hand.
Where does the SharkSpace download on sharkspace.FULLMAC.app come from?
The download button leads to the official SharkSpace releases page on GitHub at https://github.com/SSBun/Shark/releases/latest. sharkspace.FULLMAC.app does not change or repackage the app.
Similar Apps
OrbStackOrbStack is a fast, light and simple way to run Docker containers and Linux machines on your Mac. It is a drop-in replacement for Docker Desktop: your docker and docker compose commands keep working, and on first start OrbStack offers to copy over your existing Docker Desktop containers, images and volumes. It starts in seconds, uses less than 0.1% background CPU on Apple Silicon and returns unused memory to macOS. Besides containers it runs full Linux machines from 16 distributions, and a lightweight Kubernetes cluster for local development. OrbStack is made by Orbital Labs.Developer Tools- RazorSQLRazorSQL is an SQL query tool, database browser, SQL editor and database administration tool from Richardson Software, LLC. It has been tested on over 40 databases and connects through JDBC or ODBC, with support for systems such as MySQL, PostgreSQL, Oracle, MS SQL Server, SQLite, MariaDB, MongoDB, Snowflake, DuckDB and Redshift. A database navigator lets you browse schemas, tables, columns, keys, views, indexes, procedures and functions, and visual tools create, alter, describe and drop these objects without writing the statements by hand. RazorSQL is also available for Windows, Linux and Solaris.Developer Tools
CorkCork is a graphical companion app for Homebrew, the popular package manager for macOS. Instead of typing commands in the Terminal, you look up formulae and casks, press Install, and Cork does the rest. You can add taps for more packages, uninstall anything you no longer need, see detailed information about packages and taps that Homebrew does not show easily, clear old caches to free up space, and start and stop Homebrew services. Cork needs Homebrew itself to be installed.Developer Tools
SerialSerial is a terminal app for connecting your Mac to just about anything: routers, switches, firewalls, servers, industrial control and IoT devices. It has built-in support for almost every USB serial adapter, from FTDI, Silicon Labs, Prolific, TI, Microchip and more, so you do not need to find and install drivers. It is also a full SSH client with an identity manager, and supports Telnet with RFC2217 remote serial port control and raw TCP sockets.Developer Tools
Cocoa Packet AnalyzerCocoa Packet Analyzer is a native Mac network protocol analyzer and packet sniffer. It captures traffic on Ethernet and Wi-Fi, dissects each packet as it arrives and shows it field by field, with more than 50 protocol analyzers. It can record which app sent or received each packet, so you see Safari or your own app rather than an anonymous connection, and an Applications window adds up packets and bytes per app while the capture runs. It reads and writes pcap and pcapng files, so you can also open traces made with other tools.Developer Tools
BlocsBlocs is a visual web design app for Mac that lets you create responsive websites without writing code. You build pages by stacking pre-made sections called Blocs, fill them with components called Brics, and style everything with visual controls. Sites are built on the Bootstrap 5 framework, so they adapt to any screen size, and the app works offline.Developer Tools
FULLMAC.app does not host this app. Download buttons lead to the developer’s own pages.