lcm-memory · diff
git:20260322.59781cb to git:20260401.02a1529
10 added, 10 removed. Audit A to A.
---
name: lcm-memory
description: Lossless context management — search and store persistent memory across sessions
---
# Lossless Context Management
> **Before responding to code tasks, check memory first.**
> Code task? → `lcm search` FIRST. Completed work? → `lcm store` BEFORE done.
You have access to a persistent memory system that survives across conversations.
## Workflow
Code task received → `lcm search` FIRST → Work → `lcm store` → Done
Non-code task → Just respond normally
## Commands
### 1. Search Memory
Retrieve relevant context before starting work.
```bash
lcm search "How is authentication implemented?"
```
### 2. Grep Memory
Regex pattern search for precise matches.
```bash
- lcm grep "createDaemon|startMcpServer"
+ lcm grep "createDaemon|startMcpServer" --mode regex
```
- ### 3. Expand Topic
- Get detailed expansion on a memory topic.
+ ### 3. Describe Memory
+ Inspect a specific node returned by search or grep.
```bash
- lcm expand "hook auto-heal system"
+ lcm describe sum_abc123def456
```
- ### 4. Store Knowledge
- Persist important knowledge after completing work.
+ ### 4. Expand Memory
+ Recover lower-level detail from a summary node.
```bash
- lcm store "Auth middleware uses JWT with 24h expiry. See src/middleware/auth.ts"
+ lcm expand sum_abc123def456 --depth 2
```
- ### 5. Describe Memory
- Show metadata about the memory system.
+ ### 5. Store Knowledge
+ Persist important knowledge after completing work.
```bash
- lcm describe
+ lcm store "Auth middleware uses JWT with 24h expiry. See src/middleware/auth.ts"
```
### 6. Stats
Show token savings and compression ratios.
```bash
lcm stats
```
## Decision Table
| Task Type | Search? | Store? |
|-----------|---------|--------|
| Add/create/implement feature | MUST | MUST |
| Fix/debug/resolve bug | MUST | MUST |
| Refactor/optimize/move code | MUST | MUST |
| Write/add tests | MUST | MUST |
| "How does X work?" (codebase) | MUST | Only if insights |
| General concept question | NO | NO |
| Meta task (run tests, build) | NO | NO |
| Git task (commit, PR, push) | NO | NO |
## Error Handling
- If `lcm` is not found: run `npm install -g @lossless-claude/lcm`
- If daemon is down: run `lcm daemon start --detach`
- If search returns nothing: memory may be empty — proceed normally
- Check status: `lcm doctor`