@memnexus-ai/cli 1.7.56 → 1.7.57
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rules-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,QAAA,MAAM,YAAY,wFACgE,CAAC;AACnF,QAAA,MAAM,UAAU,gCAAgC,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"rules-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,QAAA,MAAM,YAAY,wFACgE,CAAC;AACnF,QAAA,MAAM,UAAU,gCAAgC,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AA4MpC;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,oBAAoB,GACjC,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE"}
|
|
@@ -28,31 +28,53 @@ Save a memory after:
|
|
|
28
28
|
|
|
29
29
|
## MCP Tools Quick Reference
|
|
30
30
|
|
|
31
|
+
### Context & Planning
|
|
32
|
+
| Tool | Purpose |
|
|
33
|
+
|------|---------|
|
|
34
|
+
| \`build_context\` | Get a briefing before starting work — returns active work, key facts, gotchas, recent activity, and patterns. **Use this first when starting any task.** |
|
|
35
|
+
|
|
31
36
|
### Save & Update
|
|
32
37
|
| Tool | Purpose |
|
|
33
38
|
|------|---------|
|
|
34
39
|
| \`create_memory\` | Save a new memory with content, optional topics, and conversationId |
|
|
35
|
-
| \`manage_memory\` | Update content/topics
|
|
40
|
+
| \`manage_memory\` | Update content/topics, or delete by ID (requires \`confirmDeletion: true\` for deletes) |
|
|
36
41
|
|
|
37
42
|
### Search & Retrieve
|
|
38
43
|
| Tool | Purpose |
|
|
39
44
|
|------|---------|
|
|
40
|
-
| \`search_memories\` | Search by query (
|
|
41
|
-
| \`get_memory\` | Retrieve
|
|
42
|
-
| \`recall\` | AI-synthesized digest
|
|
43
|
-
| \`conversations\` | List conversations, or get a summary
|
|
45
|
+
| \`search_memories\` | Search by query with \`mode\` (\`"unified"\`, \`"content"\`, \`"facts"\`), filter by \`topics\`/\`excludeTopics\`/\`recent\`, sort with \`sortBy\`/\`order\` |
|
|
46
|
+
| \`get_memory\` | Retrieve by ID or named key. Set \`detail\` to \`"minimal"\`, \`"standard"\`, or \`"full"\` for relationship depth |
|
|
47
|
+
| \`recall\` | AI-synthesized digest — set \`format\` to \`"structured"\`, \`"narrative"\`, \`"timeline"\`, or \`"status-report"\` |
|
|
48
|
+
| \`conversations\` | List conversations, or get a \`"summary"\`/\`"timeline"\` view for a specific conversation |
|
|
44
49
|
|
|
45
50
|
### Explore & Analyze
|
|
46
51
|
| Tool | Purpose |
|
|
47
52
|
|------|---------|
|
|
48
53
|
| \`knowledge_graph\` | Explore extracted facts (\`type: "facts"\`), browse/search topics (\`type: "topics"\`), or discover related topics (\`type: "related_topics"\`) |
|
|
49
|
-
| \`patterns\` | Detect
|
|
54
|
+
| \`patterns\` | Detect patterns (\`action: "detect"\`), analyze trends (\`action: "analyze"\`), compile from memories (\`action: "compile"\`), or list stored (\`action: "list"\`) |
|
|
50
55
|
|
|
51
56
|
### Account
|
|
52
57
|
| Tool | Purpose |
|
|
53
58
|
|------|---------|
|
|
54
59
|
| \`get_user_profile\` | Check plan, quota, usage stats — the ONLY way to get account info |
|
|
55
60
|
|
|
61
|
+
## Starting New Work
|
|
62
|
+
|
|
63
|
+
Before diving into any task, use \`build_context\` to get a briefing:
|
|
64
|
+
|
|
65
|
+
\`\`\`
|
|
66
|
+
build_context({ context: "refactor authentication middleware", files: ["src/middleware/auth.ts"] })
|
|
67
|
+
\`\`\`
|
|
68
|
+
|
|
69
|
+
This returns in a single call:
|
|
70
|
+
- **Active work** — what you were last working on in this area
|
|
71
|
+
- **Key facts** — extracted knowledge relevant to the task
|
|
72
|
+
- **Gotchas** — recurring issues that appeared in multiple memories
|
|
73
|
+
- **Recent activity** — related memories from the last 24h (configurable via \`recent_hours\`)
|
|
74
|
+
- **Patterns** — behavioral patterns related to the work
|
|
75
|
+
|
|
76
|
+
Use the results to avoid repeating past mistakes and build on prior decisions.
|
|
77
|
+
|
|
56
78
|
## Conversation Tracking (Critical)
|
|
57
79
|
|
|
58
80
|
Group related memories into conversations to maintain context:
|
|
@@ -75,7 +97,13 @@ create_memory({ conversationId: "conv_abc123", content: "Auth refactor complete.
|
|
|
75
97
|
|
|
76
98
|
## Search & Retrieval Strategies
|
|
77
99
|
|
|
78
|
-
- **\`
|
|
100
|
+
- **\`build_context\`** — use first when starting work. Combines 5 queries into one call to give you a complete briefing.
|
|
101
|
+
- **\`search_memories\`** — primary search tool. Key parameters:
|
|
102
|
+
- \`query\` — semantic search (omit to list recent)
|
|
103
|
+
- \`mode\` — \`"unified"\` (default, searches content + facts + entities), \`"content"\`, or \`"facts"\`
|
|
104
|
+
- \`topics\`/\`excludeTopics\` — filter by topic tags
|
|
105
|
+
- \`recent\` — time filter (e.g. \`"24h"\`, \`"7d"\`, \`"2w"\`)
|
|
106
|
+
- \`sortBy\` — \`"relevance"\`, \`"createdAt"\`, \`"updatedAt"\`, or \`"eventTime"\`
|
|
79
107
|
- **\`recall\`** — AI-synthesized digest. Use for "give me an overview of X" or "get me up to speed on Y". Set \`format\` to \`"structured"\`, \`"narrative"\`, \`"timeline"\`, or \`"status-report"\`.
|
|
80
108
|
- **\`conversations\`** — list work sessions with \`recent\` filter, or get a \`"summary"\`/\`"timeline"\` view for a specific conversation.
|
|
81
109
|
- **\`knowledge_graph\`** — explore extracted knowledge:
|
|
@@ -85,6 +113,7 @@ create_memory({ conversationId: "conv_abc123", content: "Auth refactor complete.
|
|
|
85
113
|
- **\`patterns\`** — behavioral analysis:
|
|
86
114
|
- \`action: "detect"\` — find new patterns in your memories
|
|
87
115
|
- \`action: "analyze"\` — AI-generated insights and recommendations
|
|
116
|
+
- \`action: "compile"\` — compile patterns from recent memories
|
|
88
117
|
- \`action: "list"\` — view stored patterns
|
|
89
118
|
|
|
90
119
|
## Topic Conventions
|
|
@@ -99,7 +128,8 @@ Do NOT manually tag things like \`debugging\`, \`authentication\`, \`api-develop
|
|
|
99
128
|
|
|
100
129
|
## Best Practices
|
|
101
130
|
|
|
102
|
-
- **
|
|
131
|
+
- **Use \`build_context\` first** — before starting any task, get a briefing to avoid repeating mistakes
|
|
132
|
+
- **Search before asking** — use \`search_memories\` to check for existing context
|
|
103
133
|
- **Use \`get_user_profile\` for account info** — never search memories for plan/quota details
|
|
104
134
|
- **Use \`recall\` for overviews, \`search_memories\` for specific results** — recall synthesizes, search returns raw matches
|
|
105
135
|
- **Use named memories for living documents** — pass \`name\` param (e.g. \`"project-status"\`) for memories you update regularly
|
|
@@ -116,10 +146,17 @@ The \`mx\` CLI provides additional workflows beyond MCP tools:
|
|
|
116
146
|
|
|
117
147
|
| Workflow | Command |
|
|
118
148
|
|----------|---------|
|
|
149
|
+
| Context briefing | \`mx memories build-context --context "what you're working on"\` |
|
|
119
150
|
| Recent work recap | \`mx memories recap --recent 24h\` |
|
|
120
151
|
| AI digest of topic | \`mx memories digest --query "..." --digest-format structured\` |
|
|
121
152
|
| Timeline search | \`mx memories search --query "..." --timeline\` |
|
|
153
|
+
| Search by mode | \`mx memories search --query "..." --mode facts\` |
|
|
122
154
|
| Grouped by session | \`mx memories search --query "..." --group-by conversation\` |
|
|
155
|
+
| List conversations | \`mx conversations list --recent 7d\` |
|
|
156
|
+
| Conversation summary | \`mx conversations summary <conversation-id>\` |
|
|
157
|
+
| Search facts | \`mx facts search --query "..."\` |
|
|
158
|
+
| Explore topics | \`mx topics discover-related --topic "..."\` |
|
|
159
|
+
| Detect patterns | \`mx patterns detect\` |
|
|
123
160
|
| Full CLI help | \`mx agent-help\` |
|
|
124
161
|
|
|
125
162
|
Run \`mx agent-help\` for full AI-optimized documentation of all commands.`;
|
|
@@ -159,6 +196,7 @@ const AGENT_RULES = {
|
|
|
159
196
|
## Claude Desktop Tips
|
|
160
197
|
|
|
161
198
|
- All memory operations use MCP tools — no CLI access needed
|
|
199
|
+
- Use \`build_context\` first when starting a task to get a full briefing
|
|
162
200
|
- Use \`create_memory\` to save and \`search_memories\` or \`recall\` to find past context
|
|
163
201
|
- Use \`knowledge_graph\` to explore extracted facts and topic relationships
|
|
164
202
|
- Use \`get_user_profile\` to check your account status and quota`,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rules-templates.js","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;
|
|
1
|
+
{"version":3,"file":"rules-templates.js","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAuNH,oCAsBC;AAMD,oDAGC;AAlPD,MAAM,YAAY,GAChB,gFAAgF,CAAC;AAG1E,oCAAY;AAFrB,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAE1B,gCAAU;AAEjC,oEAAoE;AAEpE,SAAS,eAAe;IACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAyHmE,CAAC;AAC7E,CAAC;AAED,oEAAoE;AAEpE,SAAS,aAAa;IACpB,OAAO;;;;;;;;;;;;;;;;;;;;;2EAqBkE,CAAC;AAC5E,CAAC;AAED,oEAAoE;AAEpE,MAAM,WAAW,GAA2B;IAC1C,aAAa,EAAE;;;;;;mEAMkD;IAEjE,MAAM,EAAE;;;;;;mEAMyD;IAEjE,OAAO,EAAE;;;;;;mEAMwD;IAEjE,KAAK,EAAE;;;;;;mDAM0C;IAEjD,gBAAgB,EAAE;;;;;;;;kEAQ8C;CACjE,CAAC;AAEF,oEAAoE;AAEpE;;GAEG;AACH,SAAgB,YAAY,CAC1B,OAAe,EACf,OAAe,EACf,YAAkC;IAElC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEjD,MAAM,KAAK,GAAG;QACZ,YAAY;QACZ,iBAAiB,OAAO,aAAa,OAAO,MAAM;QAClD,EAAE;QACF,IAAI;QACJ,GAAG;QACH,aAAa;QACb,EAAE;QACF,UAAU;QACV,EAAE;KACH,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC"}
|