DevOS Cloud Code Execution Platform
The definitive technical guide to DevOS: in-browser Monaco editing, node-pty process sandboxes, live preview runtime, edge subdomain deployment, and terminal CLI integration.
1. Overview & Vision
DevOS is designed to eliminate the friction of local environment setup, dependencies, and deployment pipeline configuration. Rather than forcing developers to configure Docker, build tools, SSH keys, and remote servers just to test or share a project, DevOS provides an instant, isolated cloud computing environment in seconds.
Create a Next.js, Vite, React, Python, or Node.js sandbox in one click with instant hot-reloading.
Every project deployed receives its own live public subdomain with wildcard SSL certificates.
2. Architecture & Sandboxing Engine
DevOS isolates every project inside a virtualized process boundary utilizing an asynchronous Express and WebSocket runtime combined with in-browser bundling.
From keystroke in Monaco to live public edge deployment in seconds
In-browser VS Code Monaco editor with full language servers and multi-file tree.
Verifies RS256 session tokens, checks subscription tier quotas, and creates sandbox sessions.
Executes build processes, installs packages, and runs Node/Python servers under CPU/RAM limits.
Automatically provisions wildcard SSL ingress and routes traffic directly to the container port.
Monaco Code Editor: The same editor powering Visual Studio Code, configured with syntax highlighting for over 40 languages, multi-tab navigation, and integrated diff viewers.
Process Virtualization (Node-PTY & xterm.js): Provides full POSIX terminal emulation. Commands like npm install, git commit, and python main.py execute inside an isolated subprocess with strict CPU and RAM thresholds.
3. The Official CLI: @kontyra/devos
Every major modern developer platform — from Vercel (vercel) and GitHub (gh) to Stripe (stripe) and Cloudflare (wrangler) — maintains an official CLI because developers write code locally in their terminal.
# Run instantly without global installation:
npx @kontyra/devos
# Or install globally via npm:
npm install -g @kontyra/devosThe Interactive TUI Dashboard (devos)
When executed without flags in a directory, devos launches an interactive ASCII dashboard allowing developers to navigate actions with arrow keys:
Non-Interactive Command Matrix
| Command | Purpose | Options | Quick Copy |
|---|---|---|---|
| devos deploy | Archives and deploys folder to edge subdomain | --dir, --name, --build | |
| devos login | Saves Kontyra authentication token | --token <jwt> | |
| devos whoami | Displays active user account and tier | — | |
| devos init | Generates devos.json configuration file | — | |
| devos status | Queries edge cluster status and latency | — | |
| devos logout | Clears local stored session tokens | — |
4. Edge Subdomains & Domain Routing
Every deployment routed via DevOS maps automatically into an edge subdomain pattern with zero DNS configuration:
| Purpose | Subdomain Pattern | Example | Visit |
|---|---|---|---|
| Project Deployment | {project}-{username}.devos.kontyra.name.ng | shop-alex.devos.kontyra.name.ng | Visit → |
| Developer Portfolio | {username}.devos.kontyra.name.ng | alex.devos.kontyra.name.ng | Visit → |
| Organization Workspace | {org}.org.devos.kontyra.name.ng | acme.org.devos.kontyra.name.ng | Visit → |
5. devos.json Manifest Specification
Store a devos.json file in your repository root to configure build scripts, output artifacts, and environment variables:
{
"name": "edge-analytics",
"framework": "Next.js",
"buildCommand": "npm run build",
"outputDirectory": ".next",
"env": {
"NODE_ENV": "production",
"API_URL": "https://api.kontyra.name.ng/v1"
},
"routes": [
{ "src": "/api/(.*)", "dest": "/api/$1" },
{ "src": "/(.*)", "dest": "/$1" }
]
}6. Plugin Marketplace & Backend Services
DevOS provides pre-integrated plug-and-play backend infrastructure accessible directly within your code without third-party configuration:
Instant sign-up and sign-in modals with pre-wired OAuth and session tokens.
Serverless document database with automatic indexing and real-time listeners.
S3-compatible object storage with image optimization and pre-signed upload URLs.
Low-latency WebSocket pub/sub channels for chat, cursors, and live dashboards.
7. Bot Automation System
Automated intelligence agents monitor projects and platform activity:
Tracks git push webhooks and compiles release builds.
Awards achievement badges for deployment milestones.
Scans sandboxes for syntax errors and broken imports.
8. Collaboration, Feed & Portfolios
DevOS connects developers through integrated social feeds, university/developer chapters, and live verifiable portfolios:
- Live Developer Portfolio: Hosted at https://{username}.devos.kontyra.name.ng displaying verified deployed sandboxes, skill badges, and contributions.
- Organization Workspaces: Shared team sandboxes with role-based access control (
owner,admin,developer,viewer). - Developer Community Feed: Share code snippets, deployment milestones, and poll questions with automatic cross-posting when shipping new projects.
9. REST API & WebSocket Reference
Interact programmatically with the DevOS engine using standard HTTP requests:
curl -X POST https://api.kontyra.name.ng/v1/projects/proj_98a72b/deploy \
-H "Authorization: Bearer test-kontyra-key" \
-H "Content-Type: application/json" \
-d '{
"environment": "production",
"trigger": "cli"
}'Lists all sandboxes and project configurations.
Initializes a new project sandbox with starter template.
Triggers deployment build and allocates edge domain.