Documentation

The project's own documents, rendered from the stained-glass repository. Each code repository's CLAUDE.md has the engineering detail.

Documents

• Stained Glass OS — Claude Code Brief
• Default apps: what a Stained Glass OS user can reach
• Multi-user debt
• P7: the shell — what we would actually be starting from
• Package repository: size, hosting, and what blocks publishing
• Phase 0 report
• S2: can a machine-level wineserver be reached by patching Wine?
• Vision backlog — David's wants
• What's left (as of 2026-09-25)

Architecture decisions

• 0001. Wine build source for the image
• 0002. WoW64 mode and the image's architecture
• 0003. Display path: cage + XWayland + winex11, or winewayland
• 0004. Licensing: AGPL-3.0-or-later where possible
• 0005. Build Wine ourselves, for 32-bit support on a pure amd64 image
• 0006. Wine prohibits LLM-generated code
• 0007. The shell: extend Wine's explorer, add our own panels beside it
• 0008 — The login and lock screens run inside Wine
• 0009 — Security model for the credential UI: at least Windows, ideally better
• 0010 — Remote access to the login and lock screen
• 0011 — sg-compositor: our own Wayland compositor, starting from cage
• 0012. Principals and elevation: who is an administrator, and how anything gets to root
• 0013. File access in the shared wineserver
• 0014. Cross-process operations in the shared wineserver