v0.2.1 — Native macOS app (DMG)

Awareness v0.2.1 — Native macOS app

First installable macOS package of the Awareness desktop shell.

Download

Asset	Platform	Notes
Awareness-0.2.1-arm64.dmg	Apple Silicon (arm64)	macOS 14+

SHA-256: c1269f268817edc00c0a3eba672729f189dba76292307eb7a7dba304defeb0f2

Install

1. Open the DMG and drag Awareness.app into Applications
2. First launch: right-click → Open (ad-hoc signed; Gatekeeper may warn once)
3. Install the Python engine (the app is a native shell over awareness-api):

git clone https://github.com/nazmiefearmutcu/awareness.git
cd awareness
uv sync   # or: python3 -m venv .venv && pip install -e .
ln -s "$PWD" ~/awareness_dev   # optional; app auto-discovers this path

What's in the app

• Native SwiftUI window + WKWebView dashboard (no Safari/Chrome)
• Auto-starts / health-checks / stops the local FastAPI process
• Full SPA parity: Dashboard, Captures, Work, Pipeline, Tail, Settings, ⌘K

Build from source

./macos/Awareness/Scripts/make-dmg.sh
# → dist/Awareness-<version>-<arch>.dmg

Notes

• Not notarized (ad-hoc codesign). Use right-click → Open on first run.
• Architecture: arm64 only in this release (built on Apple Silicon).
• Tag: v0.2.1 on feat/native-macos-app (b19c72a)

See also: macos/README.md