Skip to main content
Continuum is a free, open-source (Apache-2.0) native app for Mac, iPhone, and Apple Watch. The Mac app is the host; iPhone and Watch are paired companions.
Continuum requires an Apple Silicon Mac. The Mac app is the source of truth — install it first.

​
Requirements

  • Apple Silicon Mac (the packaged DMG and the bundled-runtime path require it)
  • Xcode with Swift 5.10 support and current Apple platform SDKs (build-from-source only)
  • At least one provider CLI installed and logged in: claude, codex, cursor-agent, gemini / Antigravity (agy), grok, or opencode

​
Install via DMG

Download the latest signed and notarized DMG from GitHub Releases.
1

Download the DMG

Find the latest release on GitHub Releases. Download the Continuum-<version>-arm64.dmg asset.
2

Drag to Applications

Open the DMG and drag Continuum.app to your Applications folder.
3

Launch

Open Continuum from Applications. The app appears in the menu bar.
The DMG is Developer ID signed and notarized by Apple. Sparkle 2.9.2 handles subsequent in-app updates; update signatures use EdDSA.

​
In-app updates

Once installed, Continuum checks for updates via Sparkle from the appcast at https://darshanbathija.github.io/Continuum/updates/appcast.xml. Use Update App from the titlebar, the Settings tab, or the app menu. If Sparkle fails for any reason, the UI opens the GitHub release page as a fallback. You can disable automatic checks in Settings → Updates.

​
Build from source

1

Install xcodegen

brew install xcodegen
2

Generate the Xcode project

cd apple
xcodegen
Re-run this whenever you change project.yml.
3

Run the shared tests

cd apple/ClawdmeterShared && swift test
4

Build the Mac app

xcodebuild -scheme "Clawdmeter (Mac)" \
  -destination 'platform=macOS,arch=arm64' \
  CODE_SIGNING_ALLOWED=NO \
  build
5

Build the iPhone app (optional)

xcodebuild -scheme "Clawdmeter (iOS)" \
  -destination 'generic/platform=iOS Simulator' \
  CODE_SIGNING_ALLOWED=NO \
  build
6

Build the Watch app (optional)

xcodebuild -scheme "Clawdmeter (Watch)" \
  -destination 'generic/platform=watchOS Simulator' \
  CODE_SIGNING_ALLOWED=NO \
  build
CODE_SIGNING_ALLOWED=NO produces unsigned local builds suitable for development. To produce a signed, notarized DMG for distribution: 
./tools/build-mac-dmg.sh
The DMG script regenerates the project when xcodegen is available, archives the Mac scheme, builds a compressed DMG, verifies the mounted app, and enforces a soft and hard size budget.

​
Optional: bundled runtime staging

Continuum can bundle Node, uv, and OpenCode runtimes for faster startup. To stage them: 
./tools/download-bundled-node.sh
./tools/download-bundled-uv.sh
./tools/download-bundled-opencode.sh
To skip these during local builds and rely on system installs instead: 
CLAWDMETER_SKIP_BUNDLED_NODE=1
CLAWDMETER_SKIP_BUNDLED_UV=1
CLAWDMETER_SKIP_BUNDLED_OPENCODE=1
Skipping a variable makes the corresponding bundled feature depend on a system install or become inert in that build.

​
iPhone and Watch

The iPhone and Watch apps must be built and installed via Xcode — they are not distributed as standalone binaries today.
Analytics sync between Mac and iPhone uses iCloud Key-Value storage. Personal (free) Apple Developer team accounts cannot sign the required iCloud entitlement. On those accounts, the iPhone analytics tab shows “Waiting for Mac sync” and remains empty until the account is upgraded to a paid Apple Developer Program membership.
After installing the iPhone app, pair it with your Mac. See Pairing for setup instructions.