System Context
The system is Próx OS, a cloud-first, AI-native OS Space platform hosted at
Context
The system is Próx OS, a cloud-first, AI-native OS Space platform hosted at
https://prox-os.com.
It should be accessible as a normal website while internally behaving like a browser-based OS Shell for apps, templates, Spaces, data sources, AI context, and cloud-first workflows.
Long-term platform analogy:
GitHub: where code lives.
Hugging Face: where models, datasets, and demos live.
Prox OS: where personal AI-native workspaces, OS apps, data sources, and AI contexts live.Main Actors
Owner
The human maintainer and first user.
Responsibilities:
- Defines architecture boundaries
- Reviews AI-generated patches
- Owns production secrets
- Approves database and infrastructure changes
Visitor
A public visitor to https://prox-os.com.
May access:
- Public OS Shell surface
- Public apps
- Public datasets or pages
Authenticated User Future
A future logged-in user.
May access:
- Private windows
- Personal dashboards
- Saved app state
- Data-backed apps
- Private or unlisted Spaces
- User-approved AI Context
AI Agent
A coding or operational agent such as Codex.
May access:
- Repository files
- AI-readable docs
- Local commands with approval
Must not access:
- Production secrets
- Production database writes
- External systems without explicit permission
External Systems
- Cloudflare Pages for frontend deployment
- Cloudflare Workers for API boundary
- Cloudflare R2 for object storage
- Neon PostgreSQL for primary database
- GitHub for version control
- Hugging Face for model, dataset, and Space references
- Vercel for BYO static app deploy targets
- RSS feeds for information radar and knowledge inbox workflows
- Notion / Airtable-style cloud data sources for read-only connector exploration
- NocoDB or similar tools for human data administration
- Future MCP clients for AI integration
Platform Boundary
Current: Prox OS owns the shell, registry composition, bundled apps, docs, and
static concepts.
Planned: Prox OS should store metadata, manifests, Space index, profile,
stars, watches, and install relations before it hosts every user's code, files,
database, inference, or static app assets.
Exploration: BYO GitHub + BYO Deploy + Prox Metadata Control Plane is the
preferred early strategy for user-created apps and Spaces.