cjyyzx/.agents/skills/cli/references/memory.md

Memory Commands

Manage user memories - the AI's long-term knowledge about users.

Source: apps/cli/src/commands/memory.ts

Memory Categories

Category	Description
identity	User's name, role, relationships
activity	Recent activities and their status
context	Ongoing contexts, projects, goals
experience	Past experiences and key learnings
preference	User preferences, directives, suggestions

---

lh memory list [category]

List memory entries, optionally filtered by category.

lh memory list            # All categories
lh memory list identity   # Only identity memories
lh memory list preference # Only preferences

Option	Description
--json [fields]	JSON output

Output: Grouped by category, showing type/status and descriptions.

---

lh memory create

Create a new identity memory entry.

lh memory create [options]

Option	Description
--type <type>	Memory type
--role <role>	User's role
--relationship <rel>	Relationship description
-d, --description <desc>	Description
--labels <labels...>	Extracted labels

---

lh memory edit <category> <id>

Edit a memory entry. Options vary by category:

lh memory edit identity < id > [options]
lh memory edit activity < id > [options]
lh memory edit context < id > [options]
lh memory edit experience < id > [options]
lh memory edit preference < id > [options]

Category-specific Options

identity:

• --type <type>, --role <role>, --relationship <rel>

activity:

• --narrative <text>, --notes <text>, --status <status>

context:

• --title <title>, --description <desc>, --status <status>

experience:

• --situation <text>, --action <text>, --key-learning <text>

preference:

• --directives <text>, --suggestions <text>

---

lh memory delete <category> <id>

lh memory delete identity < id > [--yes]

---

lh memory persona

Display the compiled memory persona summary.

lh memory persona [--json [fields]]

Output: Summarized user profile built from all memory categories.

---

lh memory extract

Trigger async memory extraction from chat history.

lh memory extract [--from [--to < date > ] < date > ]

Option	Description
--from <date>	Start date (ISO format)
--to <date>	End date (ISO format)

Starts a background task that analyzes chat history and creates new memory entries.

---

lh memory extract-status

Check the status of a memory extraction task.

lh memory extract-status [--task-id [--json [fields]] < id > ]

Option	Description
--task-id <id>	Check specific task