Query and update the knowledge graph for people, teams, and organisational relationships via the manager-os memory CLI.
Commands
| Command | Purpose |
|---|---|
manager-os memory recall <query> |
Search by name or keyword. Tries exact match first, then keyword search. |
manager-os memory remember --about "Name" --content "note" |
Record a raw source note about a person, team, or concept. |
manager-os memory reconcile |
Fold unreconciled source pages into durable entity pages. |
manager-os memory relate --subject "Name" --predicate TYPE --object "Name" |
Create a relationship between entities. |
manager-os memory log "entry" |
Append to today's daily note. |
manager-os memory read <path> |
Read a memory file (e.g. areas/people/person-example.md). |
manager-os memory write <path> --content "..." |
Write a memory file (creates parent dirs). |
All commands output markdown by default. Add --json for machine-readable output.
Searching
# Find a person by name (exact match)
manager-os memory recall "Alice Chen"
# Keyword search across all entities
manager-os memory recall "architecture"
# JSON output for parsing
manager-os memory recall "Alice" --json
Privacy Labels
Results include privacy labels. Notes marked [PRIVATE] contain sensitive info (visa status, performance, compensation).
- NEVER include private notes in calendar invites, emails, Slack messages, or any external tool
Storing Notes
manager-os memory remember writes a raw source page under sources/remember/. It does not append directly to a durable entity page.
Run manager-os memory reconcile when you want unreconciled source pages folded into durable entity pages with provenance and privacy preserved.
# Regular note with source
manager-os memory remember --about "Person Example" --content "Promoted to Staff Engineer" --source "1:1 2026-01-26"
# Private/sensitive note
manager-os memory remember --about "Person Example" --content "Visa expires March 2026" --source "1:1 2026-01-26" --private
# Reconcile pending source pages into durable memory
manager-os memory reconcile
Creating Relationships
manager-os memory relate --subject "Person Example" --predicate reports_to --object "Manager Example"
manager-os memory relate --subject "Person Example" --predicate member_of --object "Team Example"
Predicates: reports_to, member_of, manages, works_with
Daily Notes
manager-os memory log "## 09:15 — Standup
- Discussed pipeline progress
- Person Example blocked on API review"
Reading/Writing Files
# Read a person file
manager-os memory read areas/people/person-example.md
# Read working memory
manager-os memory read MEMORY.md
# Write a new person file
manager-os memory write areas/people/new-person.md --content "---
name: Person Example
type: person
---
# Person Example
## Current
"
Proactive Updates
Update memories when information changes — don't wait to be asked. If you learn something new about a person in conversation, record it as a source note and reconcile it into durable memory when appropriate.