Native SwiftUI menu bar app for CCS. A thin client of the CCS local web-server: it glances per-account quota, cost and tier, and performs account control (pause/resume, set default, solo, tier-lock) from the menu bar.

The app never talks to a provider directly. Every call goes to localhost, and CCS performs any provider fetch server-side. Opening the menu fires a debounced force-refresh so the glance reflects live data without blocking the UI.

Layout

Sources/CCSBarCore — pure Foundation logic (no SwiftUI): API client, discovery handshake, models, formatting, refresh debounce. Fully unit-tested.
Sources/CCSBarApp — SwiftUI MenuBarExtra app: view-model + views.
Sources/CCSBarCheck — runnable assert harness used in place of XCTest (XCTest ships with full Xcode; this builds on a CommandLineTools toolchain).

Build and test

Requires a Swift 5.9+ toolchain (CommandLineTools is enough; full Xcode not required for build/test).

swift build                 # build all targets, including the app
swift run ccs-bar-check     # run the logic tests (exits non-zero on failure)

Discovery

The app reads ~/.ccs/bar.json (written by ccs bar launch):

{ "baseUrl": "http://127.0.0.1:3000", "port": 3000, "authMode": "loopback" }

v1 supports authMode: "loopback" only (dashboard auth disabled, localhost).

Packaging

Scripts/package_app.sh assembles CCS Bar.app from a release build and signs it. v1 uses ad-hoc signing (CCS_BAR_SIGNING=adhoc, the default); users open it the first time via right-click then Open, or clear quarantine with xattr -dr com.apple.quarantine "/Applications/CCS Bar.app". Developer ID signing + notarization (CCS_BAR_SIGNING=developer-id) is the public-launch path and is not required for ad-hoc distribution.

The app ships as CCS-Bar.app.zip on the floating ccs-bar-latest GitHub release. macos-bar/VERSION is the single semver source; bump it in the same PR when a new app version is required.

Automatic release

.github/workflows/bar-release.yml publishes the asset after a push to main that changes macos-bar/**, or from a manual workflow_dispatch run whose selected ref is main. It runs on the dedicated self-hosted macOS runner labelled ccs-bar.

Manual fallback

From a macOS machine with Swift and gh:

cd macos-bar
./Scripts/package_app.sh
gh release upload ccs-bar-latest dist/CCS-Bar.app.zip --clobber

Pass a version to package_app.sh only when intentionally overriding macos-bar/VERSION. Ad-hoc signing is the default; use CCS_BAR_SIGNING=developer-id only with the configured Apple signing and notarization credentials.