usePlatoAI

macOS-first desktop AI companion built as a Tauri app inside a pnpm/Turborepo monorepo.

Development

Install dependencies:

pnpm install

Run the desktop shell locally:

pnpm desktop:dev

The desktop command starts the Vite-powered React UI through Tauri. A local Rust toolchain is required for Tauri commands.

Baseline verification:

pnpm typecheck
pnpm test
pnpm build

Milestone 001 has a manual launch and verification path in docs/milestones/001-desktop-shell-and-first-run.md.

Local Secrets

User provider credentials must go through the native provider secret-store abstraction. On macOS, the default backend is Keychain. Local durable data may store provider metadata such as provider id, display name, auth status, and an opaque secret reference, but it must not store API keys, tokens, passwords, or other credential values.

Use .env files only for developer configuration needed to run tooling locally. Do not use .env as primary user secret storage for Plato provider credentials.