@kontyra/devos

Official CLI & Interactive Terminal Dashboard for the DevOS Cloud Code Execution Platform by Kontyra.

Deploy web applications, manage isolated cloud execution sandboxes, inspect custom subdomains (*.devos.kontyra.name.ng), and configure developer projects straight from your terminal.

⚡ Quick Start

Run Instantly via npx

No global installation required:

npx @kontyra/devos

Install Globally

npm install -g @kontyra/devos

Once installed globally, you can run either:

devos
# or
kontyra-devos

🖥️ Interactive Screen (TUI Dashboard)

When executed without arguments, devos launches a full-terminal interactive dashboard:

  ██████╗ ███████╗██╗   ██╗ ██████╗ ███████╗
  ██╔══██╗██╔════╝██║   ██║██╔═══██╗██╔════╝   DevOS Cloud Platform
  ██║  ██║█████╗  ██║   ██║██║   ██║███████╗   by KONTYRA
  ██║  ██║██╔══╝  ╚██╗ ██╔╝██║   ██║╚════██║   Version 1.0.0
  ██████╔╝███████╗ ╚████╔╝ ╚██████╔╝███████║
  ╚═════╝ ╚══════╝  ╚═══╝   ╚═════╝ ╚══════╝

╭─ PLATFORM CONTEXT ─────────────────────────────────────────────────────────╮
│ 👤 User:     @alex [DEVELOPER]                                             │
│ ☁️ Engine:   ● Online (38ms) https://devos.kontyra.name.ng                │
│ 📁 Project:  my-app [Vite] ⎇ main                                          │
│ ⚙️ Build:    npm run build  →  dist                                        │
╰────────────────────────────────────────────────────────────────────────────╯

╭─ INTERACTIVE ACTIONS ──────────────────────────────────────────────────────╮
│  ▶ 🚀 Deploy Project  Build & push current directory to DevOS Cloud Edge   │
│    [2] ⚡ Cloud Sandbox / Shell — Start isolated execution container       │
│    [3] 📁 Project Initializer — Scaffold devos.json or starter template     │
│    [4] 🌐 My Deployments & Domains — Browse live projects (*.kontyra.name.ng│
│    [5] 🔐 Kontyra SSO & Auth — Sign in with token, manage subscription     │
│    [6] ⚙️ Project Configuration — Inspect & modify build commands/env      │
│    [7] 📡 System Diagnostics — Check cluster health and edge CDN latency   │
│    [8] 📖 Docs & Shortcuts — CLI reference guide                           │
│    [9] 🚪 Exit Dashboard — Return to your terminal session                 │
╰────────────────────────────────────────────────────────────────────────────╯

Interactive Navigation & Shortcuts

| Shortcut | Action | |----------|--------| | ↑ / ↓ or j / k | Navigate menu items | | Enter | Select active action | | 1 – 9 | Quick jump to action | | b or Esc | Return to main dashboard from any sub-screen | | o | Open current live project URL in default browser | | q or Ctrl+C | Exit interactive dashboard |

🚀 Non-Interactive CLI Commands

Use these commands for automation, scripts, and CI/CD pipelines:

1. Authenticate with Kontyra Accounts

devos login

Or non-interactively in CI:

devos login --token <your-kontyra-token>

Tokens can be generated from account.kontyra.name.ng/tokens.

2. Deploy Project

devos deploy

• Auto-detects framework (Next.js, Vite, React, Vue, Node.js, Static HTML, Python)
• Archives directory (respects .gitignore)
• Builds on Kontyra Cloud Edge
• Allocates wildcard SSL and your live URL: https://<project>-<username>.devos.kontyra.name.ng

Deploy Options:

devos deploy --dir ./frontend     # Deploy specific directory
devos deploy --name my-app        # Override project name
devos deploy --build "npm run build"  # Override build command
devos deploy --output dist        # Override output folder

3. Initialize / Scaffold Project Config

devos init

Generates a devos.json manifest:

{
  "name": "my-project",
  "framework": "Vite",
  "build": "npm run build",
  "output": "dist"
}

4. Check Authentication & Plan Tier

devos whoami

Outputs user handle, Kontyra subscription tier (Community Free, Developer Tier, Growth Tier, Business Tier), and portfolio URL.

5. Check Cloud Platform Status & Edge Latency

devos status

6. Open Live Project or Web IDE

devos open        # Open live project URL in browser
devos open --ide  # Open DevOS Cloud Web IDE

7. Sign Out

devos logout

🌐 Subdomain & Domain Architecture

Every deployment routed via @kontyra/devos maps automatically:

| Purpose | Domain Format | Example | |---------|---------------|---------| | Developer Portfolio | {username}.devos.kontyra.name.ng | alex.devos.kontyra.name.ng | | Project Preview | {project}-{username}.devos.kontyra.name.ng | shop-alex.devos.kontyra.name.ng | | Production Apps | {project}-{appId}.apps.kontyra.name.ng | shop-a81k.apps.kontyra.name.ng | | Org Workspace | {orgSlug}.org.devos.kontyra.name.ng | acme.org.devos.kontyra.name.ng |

📦 Publishing & Maintenance

Publish to npm under @kontyra/devos

1. Ensure you have access to the @kontyra organization on npm.
2. In the cli directory:

npm publish --access public

Automated CI/CD

The repository includes .github/workflows/publish-cli.yml. Pushing a tag (git tag v1.0.0 && git push origin v1.0.0) or triggering the manual dispatch will build and publish @kontyra/devos automatically using GitHub Actions.

📄 License

MIT © Kontyra Cloud Platform.