Skip to main content

What Are Entities?

Entities are the nodes of your memory graph — the people, projects, companies, tools, and concepts that appear across your conversations. When you mention “Sarah” in a Slack thread, reference “TaskMaster” in a GitHub PR, and discuss “authentication” in Claude Code, CORE recognizes these as entities and connects them. Every statement in your memory links back to entities. “Sarah works on TaskMaster” connects the Person entity Sarah to the Organization entity TaskMaster through a relationship.

Core Entity Types

TypeDescriptionKey AttributesExample
PersonPeople in your networkemail, role”Sarah (Engineer, sarah@company.com)“
OrganizationCompanies, teams, groupsindustry, size”TaskMaster (Startup, Series A)“
PlacePhysical or virtual locationsaddress”San Francisco Office (123 Main St)“
EventTime-based occurrencesstartTime, endTime”TaskMaster Launch (Q2 2025)“
FileDocuments, code, and mediafileId, source”Wireframes (Figma, Updated Daily)“

Application-Specific Entities

CORE also understands entities from your connected apps:
SourceEntity Types
GitHubRepositories, issues, pull requests, commits
SlackChannels, threads
LinearIssues, projects, teams
GmailContacts, threads

How Entities Are Extracted

When CORE ingests a conversation, it automatically:
  1. Identifies entities — Names, projects, tools, and concepts are recognized from natural language
  2. Resolves duplicates — “Sarah,” “Sarah Chen,” and “@sarah” are linked to the same Person entity
  3. Creates relationships — “Sarah works on TaskMaster” creates a works_on edge between two entities
  4. Updates over time — If Sarah switches teams, CORE marks the old relationship as superseded and creates a new one with temporal metadata
This means searching for “Sarah” doesn’t just find mentions of her name — it surfaces everything connected to her: projects, decisions, conversations, code reviews, and open issues.

How Entities Connect

Entities form the backbone of your memory graph. Each entity can connect to:
  • Other entities via relationships (“Sarah works_on TaskMaster”)
  • Statements that reference them (“Sarah prefers TypeScript” is a statement about the entity Sarah)
  • Episodes where they appear (the Slack thread where Sarah was mentioned)
This structure enables relationship queries — asking “How do I know Sarah?” traverses the entity graph to find all connections: shared projects, conversations, decisions, and interactions.