Shapes
The AgentOS ontology — 73 shapes. Each shape defines what an entity is (fields, relations, display hints). Shapes can extend other shapes via also:, which makes that shape a tag on the entity — a person is also an actor; a book is also a product.
See Overview for the tactical reference and Shape design principles for the rules.
All shapes
Section titled “All shapes”account— A user’s presence on a platform — their GitHub handle, Gmail address, etcactivity— An immutable change event — a graph mutation, skill run, search, or loadactor— Base type for anything that can be attributed as “who did this” in the graphagent— alsoactor— An AI agent that acts on behalf of a user. Agents are actors — theyaircraft— alsoproduct— An aircraft type (not an individual plane). Linked from flight search resultsalbum— A curated collection of images produced by the engine or a skillapp— A graphical app (TS/React) that runs on top of the engine — browser,book— alsoproduct— A book. Books are also products, so they inherit price/brand fieldsbranch— A git branchbrand— A consumer brand. Extracted from product listingscalendar— A calendar — container for eventschannel— A content channel — typically a YouTube channel. Videos are uploaded to channelsclass— alsoevent— A scheduled, bookable group activity — gym classes, workshops, coursescommunity— An online community — a subreddit, Facebook group, or similarconversation— A message thread — an iMessage chat, WhatsApp group, email thread, Claudedns_record— A DNS record for a domain. One domain has many records (A, CNAME, MX, TXT, etc.)document— alsofile— A document — any human-readable text content with structure and authorshipdomain— A registered domain name. Also auto-created from email sender/recipient addressesemail— alsomessage— An email message. Emails are also messages — querying by “message”episode— A single episode of a podcast or show. Transcribableevent— Something that happens — at a time, optionally at a place, involving peoplefile— A file — source code, attachment, download, or any discrete digital artifactfolder— A filesystem directory or workspace. Used to track project roots,git_commit— A git commit — a single point in version control historygroup— A group or community — online group, reading group, etchardware— alsoproduct— A physical hardware product — computer, phone, appliance, componentimage— alsofile— An image file. Photos, screenshots, diagrams, artworkinvitation— An invitation to join something — an organization, a workspace, a team, ajob— A running or completed unit of work the engine is responsible for —leg— One continuous movement on a single vehicle — takeoff to landing,list— A generic collection of items. Base type for shelf (books) and playlist (videos)loaded_model— A currently loaded/running AI model instancemeeting— alsoevent— A calendar meeting — an event with virtual meeting details and transcriptsmemex— A memex — a portable knowledge graph. Named for Vannevar Bush’smessage— A single message in a conversation. Base type — email extends this viaalsomodel— An AI model — LLM, embedding model, or other ML modelnote— Private text content, primarily for the author. Journal entries, PKM notes,offer— A purchasable offer — typically a flight itinerary with a priceorder— A purchase order. Contains products and tracks deliveryorganization— alsoactor— A company, nonprofit, or other organization. Organizations are actors — theyperson— alsoactor— A real human. People are actors — they can own accounts, hold roles, attend meetingsplace— A physical location — address, building, city, or point of interestplatform— alsosoftware— A service that users interact with — Amazon, Gmail, Reddit, WhatsAppplaylist— alsolist— A video playlist. Playlists are lists that contain videos instead of productspodcast— A podcast series. Contains episodes. Not the audio itself — that’s on the episodepost— A piece of published content — a Reddit submission, HN story, YouTube upload,product— A purchasable item. Base type for book and aircraftproject— A project that groups tasks. Tasks belong to projectsquote— A notable quote. Attribution is a graph relationship, not a field —repository— A source code repositoryresult— A search result — a pointer to something found. Not the thing itselfreview— alsopost— A user review of a product. Reviews are also posts, so they carry engagement metricsrole— A person’s position at an organization (job title, board seat, etc.)search— A search query and its results. Every search is a graph entity with clicksession— An MCP session — a client connected, made some calls, disconnectedshelf— alsolist— A bookshelf. Shelves are lists that contain books instead of generic productsshortcut— A named alias that expands to a location URI at parse timesimulation— A simulation — an isolated runtime where an agent runs. The “VM”skill— A connected service/integration in agentOS. Each skill provides toolssoftware— alsoproduct— A software application — web app, desktop app, mobile app, CLI toolsource— A content source — where skills, themes, shapes, and wallpapers livespec— alsotask,file— A spec — a design document describing work to be donetag— A tag or label — Gmail label, Todoist label, GitHub label, git tag, etctask— A work item — issue, ticket, or to-do. Supports hierarchy (parent/children)theme— An OS theme — window chrome, taskbar, scrollbars, desktop stylingtool_call— A single tool invocation made by an agent during a messagetransaction— A financial transaction — credit card charge, bank transfer, etctranscript— A text transcript of audio/video content. Linked from meetings and videostrip— A directed journey from origin to destination — one direction of travelvideo— alsofile— A video file — the media artifact, not the social context around itvolume— A storage volume — local disk, external drive, network share, or cloud drivewebpage— A web page. Base type for search result. Also used for browser historywebsite— A published website (not a single page — see webpage for that)