Kaleido-Desktop/AGENTS.md
Elijah 00d72e70f4 Create Kaleido Desktop, a cinematic Plex client for Windows
Tauri 2 shell with a React/TypeScript interface and libmpv playback composed
beneath the web view (DirectComposition on Windows). Shared code with per-OS
platform modules and configs so macOS and Linux can follow.

- Plex sign-in (browser, plex.tv/link or manual), server selection, Plex Home
- Home, Movies and TV Shows (Discover, Library, Collections), search, people
- Title pages with logos, ratings, cast, extras, seasons and episodes
- Direct play with Plex conversion fallback, tracks, markers, autoplay
- Metadata editing, artwork, fix match, refresh, analyze and deletion
- Resumable offline downloads
- App settings and Plex server administration with a live dashboard
- Signed updater feed and Forgejo CI

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 16:26:37 -07:00

1.4 KiB

Kaleido Desktop

Working rules

  • This is a real desktop Plex client (Tauri 2 + React/TypeScript + libmpv), sibling of the Android TV app at git.elijahkuntz.com/Elijah/Kaleido. Preserve working Plex functionality; never substitute mock content or prototype playback.
  • Design for mouse and keyboard first. Keep Kaleido's artwork-led look (clear logos, backdrop fading into the page, UltraBlur colour wash, neutral near-black chrome) but don't port remote-control patterns that feel wrong with a pointer.
  • Keep the interface restrained: no redundant buttons or navigation.
  • .env (PLEX_SERVER_URL, PLEX_TOKEN) is for local testing only. Never print, commit or embed credentials. .tools/updater.key signs updates; never commit or replace it.
  • Shared code goes in src/ and src-tauri/src/; anything OS-specific goes in src-tauri/src/platform/<os>.rs or tauri.<os>.conf.json.

Testing

  • npm run typecheck, npm test, cargo check --manifest-path src-tauri/Cargo.toml.
  • UI: npm run dev and a browser at http://localhost:1420 (signs in from .env).
  • Native: npm run tauri dev with WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--remote-debugging-port=9333; window.__kaleido exposes the stores in development.
  • Mute before playback tests (__kaleido.useSettings.getState().set('volume', 0)). Playback changes real Plex progress and track selections; restore them.

See docs/architecture.md and docs/development.md.