MemQLCockpit.
// the machine runtime

Machines you own, in your cluster’s fleet.

The Cockpit is installed as memql. It is the runtime that brings a machine into a cluster’s Fleet, and the command line for the cluster itself. An agent reaches a machine only in sessions of the person who owns it.

// the machine edge

A machine you own runs memql worker run as a service. It dials the cluster's front door at https://api.<domain>, where the agent node holds its stream, and MemQL OS, at os.<domain>, adds it, checks it and removes it under Fleet > Machines.

// add a machine
  1. 01

    Add machine

    In MemQL OS, open Fleet > Machines > Add machine. Name the machine, pick its operating system, and choose whether it gets computer use and local models.

  2. 02

    Paste one line

    Fleet mints a machine token, shown once, and composes the install line for that platform with the token and your cluster filled in. Paste it into a terminal on the machine: it installs memql and starts it as a service, a LaunchAgent on macOS or a user systemd unit on Linux.

  3. 03

    Watch it connect

    Fleet waits for that machine’s registration, then checks it: online and steady, the build asked for, and on a computer-use Mac the Accessibility and Screen Recording permissions.

A machine that can redeem a short code interactively can use memql worker pair instead. Removing a machine is the same act in reverse, from its page in Fleet.

// what a machine offers
headless

Shell, files and HTTP on the machine, for agents acting in your sessions.

computer use

An optional build that drives the mouse and keyboard and reads the screen: macOS with its two permission prompts, Linux under X11. On Wayland the machine offers headless work only.

local models

An optional local model runtime with the recommended models, which Fleet routes calls to. You may lend a machine’s models to named people, a group or the whole cluster; its shell stays yours alone.

// the cluster CLI

The same memql command operates a cluster from a terminal, and memql --help is its command reference.

// ask and voice in MemQL OS

Talking to the cluster happens in MemQL OS, at os.<your domain>: Ask is its shared interaction surface, with voice where the cluster’s configuration provides it.

// read on · machines, install and removal → · local models → · sharing a machine → · znasllc-io/memql-cockpit →