ChronicleSchema

Version 0.4.0 · 133 classes · 102 properties

A shared language for your digital history

Chronicle brings your history from many apps, such as messages, shell commands, to-dos, and AI conversations, into one archive on your own computer. This vocabulary is how every source describes what happened, so records about the same person or thing connect.

How it’s designed

Record what happened

Every record is an Action or an Entity. Entities are recorded through the actions that involve them: a task when you complete it, a person when they message you.

Read more →

Identify records the way the source does

A key is built from the source’s own IDs, handles, or event details, so the same record gets the same identity every time it is read. Never from a generated ID.

Read more →

Connect records only on evidence

Records from different sources join through a shared key or an explicit sameAs, never by guessing. A missing link can be added later; a wrong one would merge two histories.

Read more →

Borrow from schema.org

Where schema.org has a term for something, Chronicle uses its name: Person, Action, agent, object. Each term page says how it relates to schema.org and Activity Streams. Chronicle adds what personal history needs: where each record came from and what identifies it.

Read more →

A message from Alex

Alex sent you a message on iMessage. The Message is keyed by iMessage's own ID for it, its source and sourceId, and the MessageAction by the message it sent, its result.

Alex is keyed twice. The first key is a handle in the icloud source. The second, through sameAs, is Alex's email address in the email namespace. That key doesn't belong to iMessage: any source that knows Alex's email address can use the same key.

Open this example →

{
  "@type": "MessageAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "imessage",
  "timestamp": "2026-05-09T18:22:07.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "icloud",
    "handle": "alex@example.com",
    "name": "Alex Chen",
    "sameAs": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "email",
        "handle": "alex@example.com"
      }
    ]
  },
  "result": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "imessage",
    "sourceId": "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5",
    "body": "Found the trailhead!"
  }
}

Guides

Actions

  • AcceptAction The agent accepted what was put forward, such as merging a changeset into the work it changes.
  • AddAction The agent added the object to the target, such as a track to a playlist or a work to a collection.
  • AnnotateAction The agent wrote a note on something, such as a comment on a highlighted passage, a note on a work, or a note in the margin of a page.
  • AssessAction The agent took a stance on the object, such as by liking, reacting to, rating, or reviewing it.
  • BookmarkAction The agent saved the object for later, such as a bookmarked page, an article saved to a reading list, or a book shelved as to-read.
  • CallAction The agent made a phone or video call.
  • CancelAction The agent withdrew a plan or intended activity, such as a task.
  • CheckInAction The agent announced that they were at the object, a Venue.
  • CommunicateAction The agent conveyed something to others, such as by sending a message, making a call, or checking in.
  • CompleteAction The agent finished an activity or piece of work, such as a task or a book.
  • ConsumeAction The agent took in the object, such as by reading, watching, listening to, eating, or drinking it.
  • CreateAction The agent brought a work into being.
  • DeleteAction The agent removed an entity from its source, such as by moving an item to the trash.
  • DrinkAction The agent drank the object.
  • EatAction The agent ate the object, a Meal.
  • ExecuteAction The agent ran a command or a piece of software.
  • ExperienceAction The subject went through a period of life or a life event, such as a logged block of time, a job, or a relationship.
  • FindAction The agent searched on a platform.
  • FollowAction The agent started following the object, such as an account, a feed, or a collection.
  • InteractAction The agent engaged with others, such as by communicating with them or following them.
  • JoinAction The subject joined the object organization or realm, starting a membership.
  • LeaveAction The subject left the object organization or realm, ending a membership that a JoinAction started.
  • LikeAction The agent liked the object.
  • ListenAction The agent listened to the object, such as a recording or a podcast episode.
  • MeasureAction The agent took a measurement of the object, such as a person's heart rate or weight.
  • MessageAction The agent sent a message.
  • MoveAction The agent moved from the object to the target.
  • NavigateAction The agent took one step through an information space, from the object to the target, such as following a link from one web page to another.
  • OrganizeAction The agent arranged or planned things, such as by saving, bookmarking, or scheduling.
  • PayAction The agent paid money to another agent, such as for a purchase with a card.
  • PhotographAction The agent took a photograph.
  • PlanAction The agent decided to do something, such as by creating a to-do item.
  • PublishAction The agent published or released a work, such as a post, a video, or a pull request.
  • QuoteAction The agent selected a passage of the object, such as a highlight in a book or an excerpt from a page.
  • ReactAction The agent took a stance on the object with no content, such as a like.
  • ReadAction The agent read the object, such as a book, an article, or a document.
  • RecordAction The agent recorded sound or video, such as a voice memo, a video clip, or a screen recording.
  • RejectAction The agent declined what was put forward, such as closing a changeset without taking it in.
  • RespondAction The agent responded to the object with content, such as an emoji reaction, a comment, a rating, or a review.
  • ScreenshotAction The agent captured what a screen showed, such as a web page or an app.
  • ShareAction The agent shared the object with others, such as by sending a photo in a conversation.
  • SleepAction The agent slept from startTime to endTime, such as for a night or a nap, including any brief wakings.
  • TradeAction The agent exchanged something of value with another agent, such as by buying, selling, or paying.
  • TravelAction The agent travelled from the object place to the target place, from startTime to endTime.
  • UnlikeAction The agent withdrew a like of the object, such as by removing a favorite.
  • UpdateAction The agent changed an existing entity, such as by editing a task's title or notes.
  • ViewAction The agent looked at the object, such as a web page visited, a photo opened, or a document viewed.
  • VisitAction The agent stayed at the object place from startTime to endTime.
  • WatchAction The agent watched the object, such as a video, a film, or a show.

Entities

  • AIModel A trained model that generates or interprets content, such as a language model or a speech recognizer.
  • Agent An entity that can act, such as a person, an organization, or a piece of software.
  • Article A written piece published on the web or in a periodical, such as a news story, a blog post, or a feed item.
  • AudioObject A sound recording, such as a voice message or a music file.
  • Book A book, in one edition.
  • Calendar A calendar of events, such as a person's primary calendar, a shared team calendar, or a subscribed holiday calendar.
  • CallSession One person's time on a phone or video call.
  • Category A classification from a fixed set of kinds.
  • Changeset A set of changes to a work, made as a unit, such as a pull request, a suggested edit to a document, or the text a writer added to a note in one sitting.
  • Channel A named place where several participants post messages, such as a workspace channel, a group chat, or a chat room.
  • Collection A group of entities that a source declares, such as a list, an area of responsibility, or a section of a project.
  • Command An instruction given to a computer, such as a shell command.
  • Comment A response written in prose.
  • CreativeWork A work made by an agent, such as a text, a recording, a post, a message, or a document.
  • DefinedTerm A word or code from a vocabulary that classifies other entities, such as a tag or a category.
  • Device A physical computing device the subject runs software on, such as a computer, a phone, a tablet, or a watch.
  • DeviceSession A period of using a device, such as a block of time with one app in focus.
  • Directory A filesystem directory.
  • DocumentObject A document file, such as a PDF, a text file, or a document attachment.
  • Enrollment A period of study at a school.
  • EpubCfiSelector A position in an EPUB, given by a Canonical Fragment Identifier.
  • Event A named happening with a planned start and end, such as a calendar entry, a concert, or a picnic.
  • FinancialAccount An account that money is counted in, as one line of a chart of accounts.
  • FinancialPosting One side of a FinancialTransaction: the change it made to one FinancialAccount.
  • FinancialTransaction A movement of money, such as a card purchase, a transfer between accounts, or a trade.
  • ImageObject An image file, such as a photo's file, a screenshot, or an image attachment.
  • Intangible An entity that is neither physical nor a creative work, such as a term, a selector, or a category.
  • Journey A recorded stretch of travel, with its travelMode, its distance, and its route as its path.
  • Meal A meal or snack that the subject ate.
  • MediaObject A media file, such as an image, an audio recording, a video, or a document.
  • Membership A period of belonging to an organization or realm.
  • Message A communication sent to one or more agents, such as a text message, an email, or a chat reply.
  • MovingImage A video as a work, such as one recorded with a camera or of a screen: what it shows, apart from the files that hold it.
  • MusicAlbum A released collection of music recordings.
  • MusicGroup A musical act, such as a band, an orchestra, or a solo artist as a performer.
  • MusicRecording A recording of a piece of music, such as a track on an album.
  • Note A text that its author keeps and edits, such as a note in a notes app or a page in a personal wiki.
  • OperatingSystem An operating system, or one release of it, that applications run on, such as a phone's or a computer's.
  • Organization A group of people acting as one, such as a company, an institution, a club, or a school.
  • PageSelector A position in a paginated document, given by page number.
  • PaymentCard A numbered card that payments draw on, such as a credit card or a debit card.
  • PerformingGroup An organization that performs, such as a band, a troupe, or an ensemble.
  • Person A human being, such as a participant in a conversation or the user of a computer.
  • PhysicalObject A physical object the subject owns or uses, such as a device, a vehicle, or a musical instrument.
  • Place A place in the world with an identity of its own, such as a venue, a city, a region, or a country.
  • PodcastEpisode One episode of a podcast.
  • PodcastSeries A podcast, a series of episodes published through a webFeed by a publisher.
  • Post A work published to a social or media platform, such as a feed post, a story, a reel, or a tweet.
  • ProductModel A kind of product, such as a line of phones or one model of camera, rather than one particular product.
  • Project An undertaking that groups related work toward an outcome.
  • Query A search query as it was entered.
  • Quotation A passage selected from a work, such as a highlight or an excerpt.
  • Realm A bounded account or computing domain, such as a workspace, a computer system, or an email domain.
  • Relationship A period of romantic partnership.
  • Repository A store of files and their history under version control, hosted on a forge or kept locally.
  • Response A response to something, with content.
  • Revision A version of a work in its history, such as a commit to a repository or a revision of a document or wiki page.
  • Selector A position within a resource, such as where a passage is in a book, a page, or a media file.
  • Session A period of one person's activity or experience, such as a night's sleep, a logged block of work, a trip across town, or their time on a call.
  • SleepSession A period of sleep, such as a night or a nap.
  • SleepStage A stretch of one stage of sleep, such as deep sleep, that isStageOf a SleepSession.
  • Software A program, such as an application, an operating system, or a model.
  • SoftwareAgent Software that acts as a participant, such as an assistant, a bot, or an automation.
  • SoftwareApplication A software application used to do work.
  • SoftwareSourceCode Source code as a work, such as a snippet, a script, or a program's code.
  • StillImage A still picture as a work, such as a photograph or a screenshot: what it shows, apart from the files that hold it.
  • Tag A label a source uses to categorize entities.
  • Task A unit of work to be done, such as a to-do item.
  • Tenure A period of employment.
  • Thread A conversation that its source groups together, such as an email thread or a chat with an assistant.
  • Venue A specific place that people go to, such as a café, a shop, a park, a home, or an office.
  • VideoObject A video file, such as a recorded clip or a video attachment.

More examples

Esc

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