Cybernetics

A browser-based Linux shell and IDE environment.

Installation

sudo npm install -g cybernetics

Quick Start

cybernetics login google     # Authenticate
cybernetics                  # Start server on port 8672
cybernetics tunnel           # Get HTTPS tunnel URL

Open the IDE at cybernetics-virid.vercel.app, paste the tunnel URL and your auth token in the Shell Setup modal.

Commands

| Command | Description | |---|---| | cybernetics | Start server on default port 8672 | | cybernetics -p <port> | Start server on custom port | | cybernetics login google | Authenticate with Google | | cybernetics login github | Authenticate with GitHub | | cybernetics logout | Clear all credentials | | cybernetics tunnel | Start HTTPS tunnel via cloudflared | | cybernetics show config | Show LAN IPs and connection info | | cybernetics ai "<prompt>" | Run an AI prompt | | cybernetics --version | Show version | | cybernetics --help | Show help |

Shell Setup Modal

After starting the server, open the IDE and click the gear icon in the explorer panel. Paste your tunnel URL and auth token to connect.

Docker

FROM node:20-slim

RUN apt-get update && apt-get install -y \
  python3 git curl bash zsh make g++ \
  && rm -rf /var/lib/apt/lists/*

WORKDIR /app

COPY package.json .
RUN npm install

COPY app.js .

EXPOSE 8672

CMD ["node", "app.js"]

RUN

docker build -t shell .
docker run -p 8672:8672 shell-image shell 

Or build locally:

docker build -t cybernetics .
docker run -p 8672:8672 cybernetics

Embed in Your Own Server

import { app, server, wss, resolveToken, requireAuth } from 'cybernetics';

// Mount on your own port
server.listen(3000, () => {
  console.log('Cybernetics running on port 3000');
});

Authentication

Cybernetics uses a secure HMAC-signed token system. After login, your token is saved to ~/.cybernetics/token and displayed in the terminal and at http://localhost:8672 for easy copying.

License

MIT