mirror of
https://github.com/tiennm99/ccs.git
synced 2026-10-14 08:18:04 +00:00
73 lines
2.6 KiB
Markdown
73 lines
2.6 KiB
Markdown
# CCS Bar (macOS)
|
|
|
|
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).
|
|
|
|
```bash
|
|
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`):
|
|
|
|
```json
|
|
{ "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`:
|
|
|
|
```bash
|
|
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.
|