Command · Chronicle Schema

Properties

Property	Expected type	Description
From Entity
about many	Entity	An entity representing the subject matter of this entity, such as a topic or tag describing what a task concerns.
body one	Text	The textual content of an entity, such as a shell command or message, as supplied by the source.
description one	Text	Descriptive text supplied by the source about an entity, such as a task's notes or a project's summary.
handle one	Text	A contextual identifier for an entity within its namespace, such as a username, channel slug, or tag label. Its meaning depends on the source or context in which it is used.
inRealm one	Realm	The realm in which an entity resides, such as the computer system hosting a conversation or file. Provides context for identifiers that are local to that realm.
isPartOf many	Entity	An entity that this entity forms part of, such as a task's project or collection, or the page containing an excerpt. Each value identifies a containing whole.
name one	Text	The human-readable name or title of an entity, such as a person's display name, a document title, or a place name.
sameAs many	Entity or Text	Another reference to the same entity, expressed as an entity node or a textual identity reference such as @me. Asserts shared identity, rather than similarity or association.
url one	URL	A URL at which the entity can be found, such as a web page's address or a link to a source record.
From Base
source one	Text	The source system that describes the entity or action, such as things-todo. Provides the source namespace in which identifiers such as sourceId are interpreted.
sourceId one	Text	The identifier assigned by the source to an entity or action, such as a record ID or message ID. Represented as text and scoped to the source's own namespace; it need not be globally unique.

Used as a value

A Command can be the value of these properties.

abouton Entity · accepts any Entity
instrumenton Action · accepts any Entity
isPartOfon Entity · accepts any Entity
memberOfon Agent · accepts any Entity
objecton Action · accepts any Entity
sameAson Entity · accepts any Entity

Examples

Running a shell command

An ExecuteAction for one command from shell history.

{
  "@type": "ExecuteAction",
  "@key": [
    "@type",
    "source",
    "timestamp",
    "object.body",
    "agent.handle",
    "agent.memberOf[*].handle"
  ],
  "source": "shell",
  "timestamp": "2026-03-14T09:26:53.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle", "memberOf[*].handle"],
    "source": "shell",
    "handle": "sam",
    "memberOf": [
      {
        "@type": "Realm",
        "@key": ["@type", "source", "handle"],
        "source": "hostname",
        "handle": "studio"
      }
    ],
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Command",
    "@key": ["@type", "source", "body", "action.timestamp"],
    "source": "shell",
    "body": "git log --oneline -5"
  }
}

{
  "@context": {
    "@vocab": "https://schema.chronicle.app/",
    "doc": "https://schema.chronicle.app/docs/"
  },
  "@type": "ExecuteAction",
  "doc:key": {
    "@list": [
      "@type",
      "source",
      "timestamp",
      "object.body",
      "agent.handle",
      "agent.memberOf[*].handle"
    ]
  },
  "source": "shell",
  "timestamp": {
    "@value": "2026-03-14T09:26:53.000Z",
    "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
  },
  "agent": {
    "@type": "Person",
    "doc:key": {
      "@list": ["@type", "source", "handle", "memberOf[*].handle"]
    },
    "source": "shell",
    "handle": "sam",
    "memberOf": [
      {
        "@type": "Realm",
        "doc:key": {
          "@list": ["@type", "source", "handle"]
        },
        "source": "hostname",
        "handle": "studio"
      }
    ],
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Command",
    "doc:key": {
      "@list": ["@type", "source", "body", "action.timestamp"]
    },
    "source": "shell",
    "body": "git log --oneline -5"
  }
}

@prefix : <https://schema.chronicle.app/> .
@prefix doc: <https://schema.chronicle.app/docs/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

[
  a :ExecuteAction;
  doc:key ("@type" "source" "timestamp" "object.body" "agent.handle" "agent.memberOf[*].handle");
  :source "shell";
  :timestamp "2026-03-14T09:26:53.000Z"^^xsd:dateTime;
  :agent [
    a :Person;
    doc:key ("@type" "source" "handle" "memberOf[*].handle");
    :source "shell";
    :handle "sam";
    :memberOf [
      a :Realm;
      doc:key ("@type" "source" "handle");
      :source "hostname";
      :handle "studio"
    ];
    :sameAs "@me"
  ];
  :object [
    a :Command;
    doc:key ("@type" "source" "body" "action.timestamp");
    :source "shell";
    :body "git log --oneline -5"
  ]
] .

URI https://schema.chronicle.app/Command