agent-working-memory 0.3.0 → 0.3.1
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.
- package/dist/cli.js +21 -9
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
- package/src/cli.ts +19 -9
package/dist/cli.js
CHANGED
|
@@ -12,6 +12,7 @@ import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
|
|
|
12
12
|
import { resolve, basename, join, dirname } from 'node:path';
|
|
13
13
|
import { execSync } from 'node:child_process';
|
|
14
14
|
import { fileURLToPath } from 'node:url';
|
|
15
|
+
import { homedir as osHomedir } from 'node:os';
|
|
15
16
|
const __filename = fileURLToPath(import.meta.url);
|
|
16
17
|
const __dirname = dirname(__filename);
|
|
17
18
|
// Load .env if present
|
|
@@ -39,16 +40,18 @@ function printUsage() {
|
|
|
39
40
|
AgentWorkingMemory — Cognitive memory for AI agents
|
|
40
41
|
|
|
41
42
|
Usage:
|
|
42
|
-
awm setup [--agent-id <id>] [--db-path <path>] [--no-claude-md]
|
|
43
|
-
Configure MCP for
|
|
43
|
+
awm setup [--global] [--agent-id <id>] [--db-path <path>] [--no-claude-md]
|
|
44
|
+
Configure MCP for Claude Code
|
|
44
45
|
awm mcp Start MCP server (used by Claude Code)
|
|
45
46
|
awm serve [--port <port>] Start HTTP API server
|
|
46
47
|
awm health [--port <port>] Check server health
|
|
47
48
|
|
|
48
49
|
Setup:
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
50
|
+
awm setup --global Recommended. Writes ~/.mcp.json so AWM is available
|
|
51
|
+
in every project — one brain across all your work.
|
|
52
|
+
|
|
53
|
+
awm setup Project-level. Writes .mcp.json in the current directory
|
|
54
|
+
and appends workflow instructions to CLAUDE.md.
|
|
52
55
|
|
|
53
56
|
Use --no-claude-md to skip CLAUDE.md modification.
|
|
54
57
|
Restart Claude Code after setup to pick up the new MCP server.
|
|
@@ -62,6 +65,7 @@ function setup() {
|
|
|
62
65
|
let agentId = projectName;
|
|
63
66
|
let dbPath = null;
|
|
64
67
|
let skipClaudeMd = false;
|
|
68
|
+
let isGlobal = false;
|
|
65
69
|
for (let i = 1; i < args.length; i++) {
|
|
66
70
|
if (args[i] === '--agent-id' && args[i + 1]) {
|
|
67
71
|
agentId = args[++i];
|
|
@@ -72,6 +76,10 @@ function setup() {
|
|
|
72
76
|
else if (args[i] === '--no-claude-md') {
|
|
73
77
|
skipClaudeMd = true;
|
|
74
78
|
}
|
|
79
|
+
else if (args[i] === '--global') {
|
|
80
|
+
isGlobal = true;
|
|
81
|
+
agentId = 'claude'; // unified agent ID for global setup
|
|
82
|
+
}
|
|
75
83
|
}
|
|
76
84
|
// Find the package root (where src/mcp.ts lives)
|
|
77
85
|
const packageRoot = resolve(__dirname, '..');
|
|
@@ -123,7 +131,7 @@ function setup() {
|
|
|
123
131
|
};
|
|
124
132
|
}
|
|
125
133
|
// Read or create .mcp.json
|
|
126
|
-
const mcpJsonPath = join(cwd, '.mcp.json');
|
|
134
|
+
const mcpJsonPath = isGlobal ? join(osHomedir(), '.mcp.json') : join(cwd, '.mcp.json');
|
|
127
135
|
let existing = { mcpServers: {} };
|
|
128
136
|
if (existsSync(mcpJsonPath)) {
|
|
129
137
|
try {
|
|
@@ -152,7 +160,10 @@ You have persistent memory via the agent-working-memory MCP server.
|
|
|
152
160
|
- To manage tasks: call memory_task_add, memory_task_update, memory_task_list, memory_task_next
|
|
153
161
|
`;
|
|
154
162
|
const claudeMdPath = join(cwd, 'CLAUDE.md');
|
|
155
|
-
if (
|
|
163
|
+
if (isGlobal) {
|
|
164
|
+
claudeMdAction = ' CLAUDE.md: skipped (global setup — add snippet to individual projects as needed)';
|
|
165
|
+
}
|
|
166
|
+
else if (skipClaudeMd) {
|
|
156
167
|
claudeMdAction = ' CLAUDE.md: skipped (--no-claude-md)';
|
|
157
168
|
}
|
|
158
169
|
else if (existsSync(claudeMdPath)) {
|
|
@@ -169,8 +180,9 @@ You have persistent memory via the agent-working-memory MCP server.
|
|
|
169
180
|
writeFileSync(claudeMdPath, `# ${basename(cwd)}\n${claudeMdSnippet}`);
|
|
170
181
|
claudeMdAction = ' CLAUDE.md: created with AWM workflow section';
|
|
171
182
|
}
|
|
183
|
+
const scope = isGlobal ? 'globally (all projects)' : cwd;
|
|
172
184
|
console.log(`
|
|
173
|
-
AWM configured for:
|
|
185
|
+
AWM configured ${isGlobal ? 'globally' : 'for: ' + cwd}
|
|
174
186
|
|
|
175
187
|
Agent ID: ${agentId}
|
|
176
188
|
DB path: ${dbPath}
|
|
@@ -179,7 +191,7 @@ ${claudeMdAction}
|
|
|
179
191
|
|
|
180
192
|
Next steps:
|
|
181
193
|
1. Restart Claude Code to pick up the MCP server
|
|
182
|
-
2. The memory tools will appear automatically
|
|
194
|
+
2. The memory tools will appear automatically${isGlobal ? '\n 3. One brain across all your projects — no per-project setup needed' : ''}
|
|
183
195
|
`.trim());
|
|
184
196
|
}
|
|
185
197
|
// ─── MCP ──────────────────────────────────────
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/src/cli.ts
CHANGED
|
@@ -14,6 +14,7 @@ import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
|
|
|
14
14
|
import { resolve, basename, join, dirname } from 'node:path';
|
|
15
15
|
import { execSync } from 'node:child_process';
|
|
16
16
|
import { fileURLToPath } from 'node:url';
|
|
17
|
+
import { homedir as osHomedir } from 'node:os';
|
|
17
18
|
|
|
18
19
|
const __filename = fileURLToPath(import.meta.url);
|
|
19
20
|
const __dirname = dirname(__filename);
|
|
@@ -41,16 +42,18 @@ function printUsage() {
|
|
|
41
42
|
AgentWorkingMemory — Cognitive memory for AI agents
|
|
42
43
|
|
|
43
44
|
Usage:
|
|
44
|
-
awm setup [--agent-id <id>] [--db-path <path>] [--no-claude-md]
|
|
45
|
-
Configure MCP for
|
|
45
|
+
awm setup [--global] [--agent-id <id>] [--db-path <path>] [--no-claude-md]
|
|
46
|
+
Configure MCP for Claude Code
|
|
46
47
|
awm mcp Start MCP server (used by Claude Code)
|
|
47
48
|
awm serve [--port <port>] Start HTTP API server
|
|
48
49
|
awm health [--port <port>] Check server health
|
|
49
50
|
|
|
50
51
|
Setup:
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
52
|
+
awm setup --global Recommended. Writes ~/.mcp.json so AWM is available
|
|
53
|
+
in every project — one brain across all your work.
|
|
54
|
+
|
|
55
|
+
awm setup Project-level. Writes .mcp.json in the current directory
|
|
56
|
+
and appends workflow instructions to CLAUDE.md.
|
|
54
57
|
|
|
55
58
|
Use --no-claude-md to skip CLAUDE.md modification.
|
|
56
59
|
Restart Claude Code after setup to pick up the new MCP server.
|
|
@@ -67,6 +70,7 @@ function setup() {
|
|
|
67
70
|
let agentId = projectName;
|
|
68
71
|
let dbPath: string | null = null;
|
|
69
72
|
let skipClaudeMd = false;
|
|
73
|
+
let isGlobal = false;
|
|
70
74
|
|
|
71
75
|
for (let i = 1; i < args.length; i++) {
|
|
72
76
|
if (args[i] === '--agent-id' && args[i + 1]) {
|
|
@@ -75,6 +79,9 @@ function setup() {
|
|
|
75
79
|
dbPath = args[++i];
|
|
76
80
|
} else if (args[i] === '--no-claude-md') {
|
|
77
81
|
skipClaudeMd = true;
|
|
82
|
+
} else if (args[i] === '--global') {
|
|
83
|
+
isGlobal = true;
|
|
84
|
+
agentId = 'claude'; // unified agent ID for global setup
|
|
78
85
|
}
|
|
79
86
|
}
|
|
80
87
|
|
|
@@ -132,7 +139,7 @@ function setup() {
|
|
|
132
139
|
}
|
|
133
140
|
|
|
134
141
|
// Read or create .mcp.json
|
|
135
|
-
const mcpJsonPath = join(cwd, '.mcp.json');
|
|
142
|
+
const mcpJsonPath = isGlobal ? join(osHomedir(), '.mcp.json') : join(cwd, '.mcp.json');
|
|
136
143
|
let existing: any = { mcpServers: {} };
|
|
137
144
|
if (existsSync(mcpJsonPath)) {
|
|
138
145
|
try {
|
|
@@ -162,7 +169,9 @@ You have persistent memory via the agent-working-memory MCP server.
|
|
|
162
169
|
`;
|
|
163
170
|
|
|
164
171
|
const claudeMdPath = join(cwd, 'CLAUDE.md');
|
|
165
|
-
if (
|
|
172
|
+
if (isGlobal) {
|
|
173
|
+
claudeMdAction = ' CLAUDE.md: skipped (global setup — add snippet to individual projects as needed)';
|
|
174
|
+
} else if (skipClaudeMd) {
|
|
166
175
|
claudeMdAction = ' CLAUDE.md: skipped (--no-claude-md)';
|
|
167
176
|
} else if (existsSync(claudeMdPath)) {
|
|
168
177
|
const content = readFileSync(claudeMdPath, 'utf-8');
|
|
@@ -177,8 +186,9 @@ You have persistent memory via the agent-working-memory MCP server.
|
|
|
177
186
|
claudeMdAction = ' CLAUDE.md: created with AWM workflow section';
|
|
178
187
|
}
|
|
179
188
|
|
|
189
|
+
const scope = isGlobal ? 'globally (all projects)' : cwd;
|
|
180
190
|
console.log(`
|
|
181
|
-
AWM configured for:
|
|
191
|
+
AWM configured ${isGlobal ? 'globally' : 'for: ' + cwd}
|
|
182
192
|
|
|
183
193
|
Agent ID: ${agentId}
|
|
184
194
|
DB path: ${dbPath}
|
|
@@ -187,7 +197,7 @@ ${claudeMdAction}
|
|
|
187
197
|
|
|
188
198
|
Next steps:
|
|
189
199
|
1. Restart Claude Code to pick up the MCP server
|
|
190
|
-
2. The memory tools will appear automatically
|
|
200
|
+
2. The memory tools will appear automatically${isGlobal ? '\n 3. One brain across all your projects — no per-project setup needed' : ''}
|
|
191
201
|
`.trim());
|
|
192
202
|
}
|
|
193
203
|
|