Skip to content
Cockpit0.29.0
A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

continuity.device

This device's identity, and its label

What it is

The device a published handover names: the mesh node key (created when this device has none, in the user's state directory and never in a repository), its node id, its public key — what a trust list admits — and the label a person reads. With a label, renames the device; the key and every signature it made are unchanged.

Descriptor

Canonical id
continuity.device
Module
continuity
Kind
command
Stability
experimental
Provenance
declared
Source
apps/majordomus-cli/src/capability/builtin/continuity.rs
Cache
disabled
Benchmark
waived: destructive
Tags
continuitydevices

Run

command
A command. It changes this process's own memory — not the repository — and is sent as a POST from this page's origin.

A label to give this device (`macbook-pro`, `mac-mini`): letters, digits, `.`, `_`, `-`. The key, and so the identity, is unchanged.

POST /api/v1/continuity/device

Projections

InterfaceAsWhere
MCP toolmajordomus_continuity_device-
MCP resourcenot exposed-
HTTPPOST /api/v1/continuity/deviceSwagger
Command linemajordomus continuity device-

Schemas

Input · DeviceInput
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "label": {
      "type": [
        "string",
        "null"
      ],
      "description": "A label to give this device (`macbook-pro`, `mac-mini`): letters, digits, `.`, `_`,\n`-`. The key, and so the identity, is unchanged."
    }
  },
  "description": "The input of `continuity.device`.",
  "title": "DeviceInput"
}
Output · DeviceView
{
  "type": "object",
  "properties": {
    "device": {
      "$ref": "#/$defs/Device",
      "description": "The node id and label."
    },
    "public_key": {
      "type": "string",
      "description": "The Ed25519 public key (hex): what a trust list names."
    }
  },
  "required": [
    "device",
    "public_key"
  ],
  "description": "The answer of `continuity device`.",
  "title": "DeviceView",
  "$defs": {
    "Device": {
      "type": "object",
      "properties": {
        "node": {
          "type": "string",
          "description": "The node id: the first 32 hex of the SHA-256 of the device's Ed25519 public key."
        },
        "label": {
          "type": "string",
          "description": "The display label of the device's identity file (`macbook-pro`), or the first eight\nhex of its node id when it has none."
        }
      },
      "required": [
        "node",
        "label"
      ],
      "description": "The device a record was written on: the mesh node key's id and the label its identity\nfile carries. The label is presentation; the node id is identity."
    }
  }
}

Examples

These are the capability's own benchmark cases: the same inputs the benchmark runs and the OpenAPI document shows.

default
{}