kiro-memory 1.0.2 → 1.0.4
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/README.md +34 -34
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Kiro Memory
|
|
2
2
|
|
|
3
3
|
**Persistent cross-session memory for [Kiro CLI](https://kiro.dev/).**
|
|
4
4
|
|
|
@@ -9,14 +9,14 @@
|
|
|
9
9
|
|
|
10
10
|
---
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Kiro Memory gives your Kiro agent memory that persists across sessions. It automatically captures what happened -- files changed, tools used, decisions made -- and feeds relevant context back at the start of the next session. No manual bookkeeping. Your agent picks up exactly where it left off.
|
|
13
13
|
|
|
14
14
|
## What Your Agent Sees
|
|
15
15
|
|
|
16
|
-
When a new session starts,
|
|
16
|
+
When a new session starts, Kiro Memory automatically injects previous session context:
|
|
17
17
|
|
|
18
18
|
```
|
|
19
|
-
#
|
|
19
|
+
# Kiro Memory: Previous Session Context
|
|
20
20
|
|
|
21
21
|
## Previous Sessions
|
|
22
22
|
|
|
@@ -51,19 +51,19 @@ When a new session starts, ContextKit automatically injects previous session con
|
|
|
51
51
|
npm install -g kiro-memory
|
|
52
52
|
|
|
53
53
|
# Install into Kiro CLI (hooks + MCP server + agent config)
|
|
54
|
-
|
|
54
|
+
kiro-memory install
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
Or from source:
|
|
58
58
|
|
|
59
59
|
```bash
|
|
60
60
|
git clone https://github.com/auriti-web-design/kiro-memory.git
|
|
61
|
-
cd
|
|
61
|
+
cd kiro-memory
|
|
62
62
|
npm install && npm run build
|
|
63
63
|
npm run install:kiro
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
-
Start the worker, then use Kiro as usual --
|
|
66
|
+
Start the worker, then use Kiro as usual -- Kiro Memory runs in the background:
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
69
|
npm run worker:start
|
|
@@ -71,14 +71,14 @@ npm run worker:start
|
|
|
71
71
|
|
|
72
72
|
## Kiro Integration
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
Kiro Memory registers **4 hooks** and an **MCP server** with Kiro CLI. The agent configuration is installed to `~/.kiro/agents/kiro-memory.json`:
|
|
75
75
|
|
|
76
76
|
```json
|
|
77
77
|
{
|
|
78
|
-
"name": "
|
|
79
|
-
"tools": ["read", "write", "shell", "glob", "grep", "@
|
|
78
|
+
"name": "kiro-memory",
|
|
79
|
+
"tools": ["read", "write", "shell", "glob", "grep", "@kiro-memory"],
|
|
80
80
|
"mcpServers": {
|
|
81
|
-
"
|
|
81
|
+
"kiro-memory": {
|
|
82
82
|
"command": "node",
|
|
83
83
|
"args": ["/path/to/dist/servers/mcp-server.js"]
|
|
84
84
|
}
|
|
@@ -112,7 +112,7 @@ The hooks are fully automatic. No changes to your workflow required.
|
|
|
112
112
|
+------+------+
|
|
113
113
|
|
|
|
114
114
|
SQLite + FTS5
|
|
115
|
-
(~/.
|
|
115
|
+
(~/.kiro-memory/kiro-memory.db)
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
### Hooks
|
|
@@ -137,19 +137,19 @@ The hooks are fully automatic. No changes to your workflow required.
|
|
|
137
137
|
|
|
138
138
|
| Component | Location |
|
|
139
139
|
|-----------|----------|
|
|
140
|
-
| Database | `~/.
|
|
141
|
-
| Logs | `~/.
|
|
142
|
-
| Archives | `~/.
|
|
143
|
-
| Backups | `~/.
|
|
140
|
+
| Database | `~/.kiro-memory/kiro-memory.db` |
|
|
141
|
+
| Logs | `~/.kiro-memory/logs/` |
|
|
142
|
+
| Archives | `~/.kiro-memory/archives/` |
|
|
143
|
+
| Backups | `~/.kiro-memory/backups/` |
|
|
144
144
|
|
|
145
145
|
## SDK
|
|
146
146
|
|
|
147
147
|
The TypeScript SDK provides full programmatic access to the memory system.
|
|
148
148
|
|
|
149
149
|
```typescript
|
|
150
|
-
import {
|
|
150
|
+
import { createKiroMemory } from 'kiro-memory';
|
|
151
151
|
|
|
152
|
-
const ctx =
|
|
152
|
+
const ctx = createKiroMemory({ project: 'my-project' });
|
|
153
153
|
|
|
154
154
|
// Retrieve context for the current project
|
|
155
155
|
const context = await ctx.getContext();
|
|
@@ -203,32 +203,32 @@ ctx.close();
|
|
|
203
203
|
## CLI Reference
|
|
204
204
|
|
|
205
205
|
```bash
|
|
206
|
-
|
|
206
|
+
kiro-memory <command> [options]
|
|
207
207
|
```
|
|
208
208
|
|
|
209
209
|
| Command | Alias | Description |
|
|
210
210
|
|---------|-------|-------------|
|
|
211
|
-
| `
|
|
212
|
-
| `
|
|
213
|
-
| `
|
|
214
|
-
| `
|
|
215
|
-
| `
|
|
216
|
-
| `
|
|
211
|
+
| `kiro-memory context` | `ctx` | Display current project context |
|
|
212
|
+
| `kiro-memory search <query>` | -- | Search across all stored context |
|
|
213
|
+
| `kiro-memory observations [limit]` | `obs` | Show recent observations (default: 10) |
|
|
214
|
+
| `kiro-memory summaries [limit]` | `sum` | Show recent summaries (default: 5) |
|
|
215
|
+
| `kiro-memory add-observation <title> <content>` | `add-obs` | Manually add an observation |
|
|
216
|
+
| `kiro-memory add-summary <content>` | `add-sum` | Manually add a summary |
|
|
217
217
|
|
|
218
218
|
### Examples
|
|
219
219
|
|
|
220
220
|
```bash
|
|
221
|
-
# View what
|
|
222
|
-
|
|
221
|
+
# View what Kiro Memory knows about your project
|
|
222
|
+
kiro-memory context
|
|
223
223
|
|
|
224
224
|
# Search for past work on authentication
|
|
225
|
-
|
|
225
|
+
kiro-memory search "OAuth token refresh"
|
|
226
226
|
|
|
227
227
|
# Show the last 20 observations
|
|
228
|
-
|
|
228
|
+
kiro-memory observations 20
|
|
229
229
|
|
|
230
230
|
# Manually record a decision
|
|
231
|
-
|
|
231
|
+
kiro-memory add-observation "Architecture Decision" "Chose PostgreSQL over MongoDB for ACID compliance"
|
|
232
232
|
```
|
|
233
233
|
|
|
234
234
|
## Configuration
|
|
@@ -237,10 +237,10 @@ contextkit add-observation "Architecture Decision" "Chose PostgreSQL over MongoD
|
|
|
237
237
|
|
|
238
238
|
| Variable | Default | Description |
|
|
239
239
|
|----------|---------|-------------|
|
|
240
|
-
| `
|
|
241
|
-
| `
|
|
242
|
-
| `
|
|
243
|
-
| `
|
|
240
|
+
| `KIRO_MEMORY_DATA_DIR` | `~/.kiro-memory` | Base directory for all Kiro Memory data |
|
|
241
|
+
| `KIRO_MEMORY_WORKER_HOST` | `127.0.0.1` | Worker service bind address |
|
|
242
|
+
| `KIRO_MEMORY_WORKER_PORT` | `3001` | Worker service port |
|
|
243
|
+
| `KIRO_MEMORY_LOG_LEVEL` | `INFO` | Log verbosity: `DEBUG`, `INFO`, `WARN`, `ERROR` |
|
|
244
244
|
| `KIRO_CONFIG_DIR` | `~/.kiro` | Kiro CLI configuration directory |
|
|
245
245
|
|
|
246
246
|
### Worker Management
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "kiro-memory",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.4",
|
|
4
4
|
"description": "Persistent cross-session memory for Kiro CLI. Automatically tracks context, observations, and summaries across coding sessions.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"kiro",
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"plugin"
|
|
42
42
|
],
|
|
43
43
|
"bin": {
|
|
44
|
-
"
|
|
44
|
+
"kiro-memory": "./plugin/dist/cli/contextkit.js"
|
|
45
45
|
},
|
|
46
46
|
"engines": {
|
|
47
47
|
"node": ">=18.0.0",
|