@muthuishere/crossmem 0.1.1 → 0.1.2
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 +96 -2
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,3 +1,97 @@
|
|
|
1
|
-
#
|
|
1
|
+
# crossmem
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Portable context memory across local agent tools.**
|
|
4
|
+
|
|
5
|
+
`crossmem` discovers your local Claude Code, Codex, Devin, and Copilot session stores, lists available sessions, and emits a clean context bundle that can be loaded into another agent session — so context follows you across tools and repos.
|
|
6
|
+
|
|
7
|
+
It is primarily a fast, local-first context CLI. It sends no telemetry; everything is local reads.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
npm install -g @muthuishere/crossmem
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
This package is a thin launcher that resolves a prebuilt native binary for your platform (`darwin-arm64`, `darwin-x64`, `linux-arm64`, `linux-x64`, `windows-x64`) via optional dependencies — no compiler or Go toolchain required.
|
|
16
|
+
|
|
17
|
+
Also available via:
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
go install github.com/muthuishere/crossmemcli/cmd/crossmem@latest # Go
|
|
21
|
+
brew install muthuishere/tap/crossmem # Homebrew
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Usage
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
crossmem scan # discover known local context stores
|
|
28
|
+
crossmem list --provider claude --limit 20 # list recent sessions
|
|
29
|
+
crossmem list --provider devin --limit 10
|
|
30
|
+
crossmem load . # print a portable context bundle for this repo
|
|
31
|
+
crossmem load . --provider codex --out .crossmem/context.md
|
|
32
|
+
crossmem update . # write durable .crossmem/ context files
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Every command has built-in help:
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
crossmem --version
|
|
39
|
+
crossmem help load
|
|
40
|
+
crossmem help scan
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### Commands
|
|
44
|
+
|
|
45
|
+
| Command | What it does |
|
|
46
|
+
| --- | --- |
|
|
47
|
+
| `scan` | Discover known local stores without reading transcript contents. |
|
|
48
|
+
| `list` / `sessions` | List available sessions across stores; filter with `--provider` / `--folder`. |
|
|
49
|
+
| `load` / `context` | Print a portable context bundle for a repo or folder. |
|
|
50
|
+
| `update` | Write durable `<folder>/.crossmem/` files (`context.md`, `guardrails.md`, `sessions.json`, `sources.json`). |
|
|
51
|
+
| `guardrails` | Print the repo instruction files an agent should read first. |
|
|
52
|
+
| `install --skills` | Install the optional global `crossmem-loader` skill. |
|
|
53
|
+
|
|
54
|
+
## Local stores
|
|
55
|
+
|
|
56
|
+
`crossmem` reads these on-disk stores (read-only):
|
|
57
|
+
|
|
58
|
+
| Tool | Store |
|
|
59
|
+
| --- | --- |
|
|
60
|
+
| Claude Code | `~/.claude/projects/<encoded-workspace>/*.jsonl` (+ per-project `memory/`) |
|
|
61
|
+
| Codex | `~/.codex/sessions/YYYY/MM/DD/*.jsonl`, `~/.codex/history.jsonl` |
|
|
62
|
+
| Copilot (VS Code) | `~/Library/Application Support/Code/User/workspaceStorage/<id>/.../*.jsonl` |
|
|
63
|
+
| Devin CLI | `~/.local/share/devin/cli/sessions.db` (SQLite) |
|
|
64
|
+
|
|
65
|
+
## Context bundles & guardrails
|
|
66
|
+
|
|
67
|
+
`crossmem load .` prints a bundle; `crossmem update .` writes it durably under `.crossmem/`. A bundle separates two things on purpose:
|
|
68
|
+
|
|
69
|
+
- **Guardrails** — repo instruction files (`AGENTS.md`, `CLAUDE.md`, `.agents/AGENTS.md`, `.claude/CLAUDE.md`) treated as *authoritative instructions*.
|
|
70
|
+
- **History** — recent session previews, treated as *context only*.
|
|
71
|
+
|
|
72
|
+
Summarization is intentionally left to the consuming agent (or the `crossmem-loader` skill), since different tasks need different amounts of history.
|
|
73
|
+
|
|
74
|
+
## Safety
|
|
75
|
+
|
|
76
|
+
`crossmem` reads other tools' private stores, so it is deliberately conservative:
|
|
77
|
+
|
|
78
|
+
- It never reads `*.env`, credential files, auth databases, or `vault/` directories (e.g. Devin's `credentials.toml` is skipped).
|
|
79
|
+
- Secret values are never written into generated context.
|
|
80
|
+
|
|
81
|
+
## Debugging
|
|
82
|
+
|
|
83
|
+
Observability is local and opt-in:
|
|
84
|
+
|
|
85
|
+
```sh
|
|
86
|
+
CROSSMEM_DEBUG=1 crossmem scan
|
|
87
|
+
CROSSMEM_LOG=/tmp/crossmem.log crossmem load . --limit 5
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Debug logs include command flow and local read/query failures — never transcript contents.
|
|
91
|
+
|
|
92
|
+
## Links
|
|
93
|
+
|
|
94
|
+
- Source & full docs: https://github.com/muthuishere/crossmemcli
|
|
95
|
+
- Issues: https://github.com/muthuishere/crossmemcli/issues
|
|
96
|
+
|
|
97
|
+
MIT © Muthukumaran Navaneethakrishnan
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@muthuishere/crossmem",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Portable context memory across local agent tools.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"crossmem",
|
|
@@ -33,11 +33,11 @@
|
|
|
33
33
|
"README.md"
|
|
34
34
|
],
|
|
35
35
|
"optionalDependencies": {
|
|
36
|
-
"@muthuishere/crossmem-darwin-arm64": "0.1.
|
|
37
|
-
"@muthuishere/crossmem-darwin-x64": "0.1.
|
|
38
|
-
"@muthuishere/crossmem-linux-arm64": "0.1.
|
|
39
|
-
"@muthuishere/crossmem-linux-x64": "0.1.
|
|
40
|
-
"@muthuishere/crossmem-windows-x64": "0.1.
|
|
36
|
+
"@muthuishere/crossmem-darwin-arm64": "0.1.2",
|
|
37
|
+
"@muthuishere/crossmem-darwin-x64": "0.1.2",
|
|
38
|
+
"@muthuishere/crossmem-linux-arm64": "0.1.2",
|
|
39
|
+
"@muthuishere/crossmem-linux-x64": "0.1.2",
|
|
40
|
+
"@muthuishere/crossmem-windows-x64": "0.1.2"
|
|
41
41
|
},
|
|
42
42
|
"os": [
|
|
43
43
|
"darwin",
|