Clawix is a native agent app for Mac, iPhone, Android, Windows, and Web. Bring your own model (Claude, GPT, Gemini, DeepSeek, or run one locally), talk to it, give it skills and memory, let it drive your browser and your Mac, and pick the thread back up on whatever device you have to hand.
This repository is a monorepo. Platform clients live at the root under
macos/, ios/, android/, windows/, web/, and linux/, with shared
Swift packages under packages/.
flowchart LR
mac["Mac"] -.-> clawix
iphone["iPhone"] -.-> clawix
android["Android"] -.-> clawix
windows["Windows"] -.-> clawix
web["Web"] -.-> clawix
clawix(["Clawix"]) --> tools(["Tools"])
clawix --> agents(["Agents"])
tools --> voice["Voice to Text"]
tools --> browser["Browser"]
tools --> screen["Screen tools"]
tools --> macu["Mac Utilities"]
tools --> quick["QuickAsk"]
agents --> skills["Skills"]
agents --> memory["Memory"]
agents --> models(["Models"])
models --> local["Local"]
models --> claude["Claude"]
models --> gpt["GPT"]
models --> gemini["Gemini"]
models --> deepseek["DeepSeek"]
models --> more["Groq · xAI · Mistral"]
Under the hood, Clawix runs on ClawJS, the framework that owns storage,
contracts, and the claw CLI. Clawix is the experience on top: pairing,
native permissions, approvals, previews, and visual state. The macOS app
ships today, with iOS, Android, Windows, and Web on the way.
Long-lived architecture, storage, naming, validation, release, and privacy
decisions are indexed in docs/decision-map.md.
Native SwiftUI client. Project sidebar with chat history and inline search, file references for apply_patch operations, model picker, native chrome, signed and notarized builds with Sparkle self-updates. Source under macos/.
A native iOS companion is on the way. It pairs with the Mac over a local bridge so projects, chats and streaming history stay in sync. Pick up a thread on the phone, keep typing on the Mac. Source under ios/.
Signed and notarized DMG builds are published on the GitHub Releases page. The app self-updates via Sparkle; when a new release is available a small "Update" chip appears in the top bar.
Requirements: macOS 14+, Swift 5.9+, Xcode Command Line Tools.
bash macos/scripts/dev.sh
Compiles debug, kills the previous instance, relaunches. Window position, size and the sidebar prefs persist via UserDefaults. With no extra config, the build is ad-hoc-signed and bundled as com.example.clawix.desktop (a placeholder); macOS will re-prompt for permissions (Desktop folder, microphone, etc.) on every relaunch. This source/community dev path is not valid evidence for closing visible app bugs, signed-host behavior, or native-permission work unless the configured signed-host preflight for the current build also passes.
Set signing values in the environment, or point CLAWIX_SIGNING_ENV_FILE at a shell-compatible local file outside this repo:
SIGN_IDENTITY="<codesign identity>"
BUNDLE_ID="com.yourdomain.clawix"
Both dev.sh and build_app.sh read those values when present. With a stable identity + bundle id, macOS remembers the TCC grants between rebuilds and stops re-prompting. Keep any local env file outside the public tree.
List your codesign identities with security find-identity -v -p codesigning. Any valid macOS codesign identity works for local source/community development. Host-visible closure and signed-host validation still require the approved preflight evidence: expected bundle id, non-ad-hoc signature, authorized Team ID, canonical launcher path, and current build metadata.
Environment variables also work and override the file:
SIGN_IDENTITY="..." BUNDLE_ID="..." bash macos/scripts/dev.sh
bash macos/scripts/build_app.sh
Builds macos/build/Clawix.app. Uses the same SIGN_IDENTITY / BUNDLE_ID resolution as dev.sh.
For notarized DMG distribution use macos/scripts/build_release_app.sh, which reads DEVELOPER_ID_IDENTITY from the environment and applies hardened-runtime per-component signing in the order Sparkle requires. The full release pipeline (notarization, DMG, appcast generation, GitHub release upload) is private to the maintainer and not part of this public tree.
The marketing version lives in macos/VERSION. It is the single source of truth: build scripts read it at compile time and inject it into CFBundleShortVersionString.
Warning
Clawix surfaces are classified explicitly in the interface matrix. Current surfaces must be stable, dev-only, or removed; beta and experimental labels do not exempt a surface from ownership, fixtures, parity, or validation.
Do not connect dev-only surfaces to sensitive systems, real user data, paid APIs, security-critical services, or important integrations.
Pre-public compatibility is not preserved unless an ADR grants a bounded exception; obsolete beta, experimental, or legacy paths are removed or hidden during the v1 surface closure.
Clawix may help with sensitive local records, summaries, searches, and non-final drafts, but it does not replace regulated professionals or make final medical, mental health, legal, financial, insurance, employment, education, government, emergency, or physical-safety decisions. See SAFETY.md and REGULATED_DOMAINS.md.
Official Clawix builds are maintained by upstream. Source builds, community builds, forks, and compatible products are allowed by the license when they use distinct identity and do not imply official status. See FORKS.md, NOTICE, and TRADEMARKS.md.
This repository never contains the maintainer's real codesign identity, Apple Team ID, or bundle id. They live outside the public tree and are injected through environment variables. The hygiene gate (macos/scripts/public_hygiene_check.sh) blocks publishing if those values or private workflow paths leak into the public source. See AGENTS.md and docs/host-ownership.md for the full set of rules contributors are expected to follow.
See CONTRIBUTING.md. The repository conventions (corner-radius canon, dropdown style, hygiene gate, signing rules) live in AGENTS.md, with framework/host ownership in docs/host-ownership.md.
The source code and documentation are licensed under MIT.
The Clawix name, logo, app icon, custom icons, custom typefaces, SVG marks, brand assets, screenshots, marketing assets, and visual identity are reserved and are not licensed under MIT. See NOTICE and TRADEMARKS.md.
Forks and compatible builds are welcome when they use distinct identity and do not imply official Clawix status. See FORKS.md.