apps

Apps

This directory contains OpenScout's runnable application surfaces. The broker and shared protocol live in packages/; apps are the host-specific ways humans and services interact with that local control plane.

Directory Map

Path	Purpose	Start here
desktop	Main desktop app, CLI command handlers, terminal UI, and app-layer services	desktop/README.md
ios	Scout iOS app and mobile human surface	ios/README.md
macos	Native macOS menu bar shell and launch affordances	macos/README.md
mesh-front-door	Cloudflare Worker rendezvous and push relay service	mesh-front-door/README.md
cloud	Small hosted API/review surfaces for feedback and intent capture	cloud/README.md
scout	Compatibility entrypoint for the old app path	scout/README.md

OpenScout remains local-first. Hosted app surfaces support setup, feedback, rendezvous, or notification flows; they are not the canonical broker and should not store broker-owned coordination records.

Common Commands

From the repo root:

bun run dev
bun run --cwd apps/desktop check
bun run --cwd apps/mesh-front-door check
bun run --cwd apps/cloud check

Read Next

• ../README.md for the repo overview
• ../packages/README.md for shared packages
• ../docs/architecture.md for the broker/runtime/protocol model
• ../docs/current-posture.md for maturity and trust boundaries