ChronicleSchema

An ExecuteAction for one block of app usage recorded by Timing. The action carries the measured span, the app as its object, and the Device as its instrument. Its result is the DeviceSession: the Directory the terminal was in (workingDirectory), the Project it counted toward (isPartOf), and the window title as its name.

The device is keyed by Timing's ID for it, with its hardware address linked through sameAs. Its model is Apple's identifier for its hardware. The directory is keyed by its path within the machine it lives on (inRealm), the same Realm the device runs in.

{
  "@type": "ExecuteAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "timing-app",
  "startTime": "2026-03-14T09:20:00.000Z",
  "endTime": "2026-03-14T09:25:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source"],
    "source": "timing-app",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "SoftwareApplication",
    "@key": ["@type", "source", "handle"],
    "source": "apple-bundle-id",
    "handle": "com.mitchellh.ghostty",
    "name": "Ghostty"
  },
  "instrument": [
    {
      "@type": "Device",
      "@key": ["@type", "source", "sourceId"],
      "source": "timing-app",
      "sourceId": "1234567890123456789",
      "name": "pat-mbp",
      "model": "Mac15,3",
      "sameAs": [
        {
          "@type": "Device",
          "@key": ["@type", "source", "handle"],
          "source": "mac-address",
          "handle": "00:11:22:33:44:55"
        }
      ],
      "inRealm": {
        "@type": "Realm",
        "@key": ["@type", "source", "handle"],
        "source": "hostname",
        "handle": "pat-mbp"
      }
    }
  ],
  "result": {
    "@type": "DeviceSession",
    "@key": ["@type", "source", "sourceId"],
    "source": "timing-app",
    "sourceId": "101",
    "name": "npm test",
    "isPartOf": [
      {
        "@type": "Project",
        "@key": ["@type", "source", "sourceId"],
        "source": "timing-app",
        "sourceId": "2",
        "name": "Chronicle"
      }
    ],
    "workingDirectory": {
      "@type": "Directory",
      "@key": ["source", "handle", "inRealm.handle"],
      "source": "filesystem",
      "handle": "/Users/pat/projects/chronicle",
      "name": "chronicle",
      "inRealm": {
        "@type": "Realm",
        "@key": ["@type", "source", "handle"],
        "source": "hostname",
        "handle": "pat-mbp"
      }
    }
  }
}

Terms in this example

DeviceDeviceSessionDirectorymodelworkingDirectory

Esc

↑↓ to move↵ to open/ or ⌘K to search