apsolut-cortex 0.1.0
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 +88 -0
- package/dist/cli.js +1364 -0
- package/dist/hooks/post-tool-use.js +5577 -0
- package/dist/hooks/session-end.js +38093 -0
- package/dist/hooks/session-start.js +972 -0
- package/dist/hooks/stop.js +1000 -0
- package/dist/mcp/server.js +48099 -0
- package/package.json +43 -0
package/README.md
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# apsolut-cortex
|
|
2
|
+
|
|
3
|
+
Persistent memory for Claude Code projects.
|
|
4
|
+
|
|
5
|
+
Stores corrections, decisions, and patterns across sessions so Claude stops
|
|
6
|
+
repeating the same mistakes and forgetting what you've already decided.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Install (one time)
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
cd ~/tools
|
|
14
|
+
git clone ... apsolut-cortex
|
|
15
|
+
cd apsolut-cortex
|
|
16
|
+
bun install
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Per project
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
cd ~/your-project
|
|
23
|
+
bun run ~/tools/apsolut-cortex/src/cli.ts init
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Restart Claude Code. Done.
|
|
27
|
+
|
|
28
|
+
## How it works
|
|
29
|
+
|
|
30
|
+
**During sessions:**
|
|
31
|
+
- Tool failures and config reads are captured automatically
|
|
32
|
+
- Transcript is scanned for self-corrections when Claude stops
|
|
33
|
+
- Say `"remember <topic>"` to search memory on demand
|
|
34
|
+
|
|
35
|
+
**At session end:**
|
|
36
|
+
- Observations compressed into memories via Claude Haiku
|
|
37
|
+
- If no `ANTHROPIC_API_KEY`: falls back to Ollama, then fails loudly
|
|
38
|
+
- Session summary stored for your own review
|
|
39
|
+
- Stale memories decay, low-value ones get pruned
|
|
40
|
+
|
|
41
|
+
**Memory is on-demand, not pre-loaded.**
|
|
42
|
+
Sessions start clean. Claude uses `memory_search` when it needs context,
|
|
43
|
+
not speculatively at the start of every session.
|
|
44
|
+
|
|
45
|
+
## MCP tools Claude can call
|
|
46
|
+
|
|
47
|
+
| Tool | When to use |
|
|
48
|
+
|------|------------|
|
|
49
|
+
| `memory_search(query)` | "remember auth", "remember what we decided about queues" |
|
|
50
|
+
| `memory_store(content, category, tier)` | After any important discovery or decision |
|
|
51
|
+
| `memory_rate(id, score)` | After using a retrieved memory (0-3) |
|
|
52
|
+
| `memory_contradict(id, correction?)` | When a memory is wrong |
|
|
53
|
+
| `memory_status()` | Overview of what's stored |
|
|
54
|
+
|
|
55
|
+
## Trust levels
|
|
56
|
+
|
|
57
|
+
`observed` → `validated` → `proven` → `canonical`
|
|
58
|
+
|
|
59
|
+
Observed: just captured. Validated: rated useful 3+ times. Proven/Canonical: human
|
|
60
|
+
promotion only (future dashboard).
|
|
61
|
+
|
|
62
|
+
## Compression providers
|
|
63
|
+
|
|
64
|
+
1. `ANTHROPIC_API_KEY` → Claude Haiku (recommended)
|
|
65
|
+
2. Ollama at `localhost:11434` → `qwen2.5-coder:7b` by default
|
|
66
|
+
- Override model: `CORTEX_OLLAMA_MODEL=llama3.1`
|
|
67
|
+
- Override host: `OLLAMA_HOST=http://...`
|
|
68
|
+
3. Neither available → loud error, observations saved for next session
|
|
69
|
+
|
|
70
|
+
## Status
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
bun run ~/tools/apsolut-cortex/src/cli.ts status
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Uninstall
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
bun run ~/tools/apsolut-cortex/src/cli.ts uninstall
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Memory DB at `~/.apsolut/memory.db` is kept. Delete manually for clean slate.
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
**What this is NOT:** a brain, an agent, a code analyser.
|
|
87
|
+
It is a spine — it carries signals forward across sessions without doing the thinking.
|
|
88
|
+
The intelligence is still Claude's.
|