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

FULLMAC.app does not host this app. Download buttons lead to the developer’s own pages.