corvusmem 0.6.0 → 0.6.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/CHANGELOG.md +12 -0
- package/README.md +4 -0
- package/commands/corvus-absorb.md +9 -6
- package/commands/corvus-cortex.md +3 -1
- package/cortex/cortex.mjs +6 -15
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,18 @@ All notable changes to **Corvusmem** are documented here.
|
|
|
4
4
|
Format based on [Keep a Changelog](https://keepachangelog.com/); versions follow [SemVer](https://semver.org/).
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
|
+
### Fixed
|
|
8
|
+
- **`/corvus-absorb` works on a WSL project.** The command hard-coded `npx corvusmem import`, and a Windows `npx`
|
|
9
|
+
cannot reach a WSL path (`\\wsl$\…`, no UNC support), so the agent's absorb failed across the boundary. It now uses
|
|
10
|
+
the installed local CLI (`node "<…>/cli/corvusmem.mjs"`) like `/corvus-cortex` and `/corvus-install`, with `npx` only
|
|
11
|
+
as the fallback. README and docs gained a WSL note (run Claude Code and Corvus on the Linux side) and the **Node ≥18**
|
|
12
|
+
requirement is now explicit.
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
- **The Cortex is dark-only, opens in 3D, and pops the browser.** Removed the light-mode toggle (the standalone Cortex
|
|
16
|
+
is always dark; the web-embedded brain still follows the page theme so it is not a black box on a light page); the
|
|
17
|
+
view now starts in **3D** by default (2D still a click away); and `/corvus-cortex` now opens the generated HTML in the
|
|
18
|
+
browser immediately instead of only printing its path.
|
|
7
19
|
|
|
8
20
|
## [0.6.0] — 2026-11-18
|
|
9
21
|
### Added
|
package/README.md
CHANGED
|
@@ -100,6 +100,10 @@ project (`--global`, in your home). It does **not** change where memory lives: p
|
|
|
100
100
|
project, then commit `.corvusmem/` (the shared project memory) and `.claude/settings.json` — teammates get Corvus firing
|
|
101
101
|
the moment they clone, with nothing to install. Never commit `~/.config/corvusmem/` — that is your private memory.
|
|
102
102
|
|
|
103
|
+
**On WSL**: if your project lives in WSL (`\\wsl$\…`), run **Claude Code and Corvus from inside WSL** so Node and
|
|
104
|
+
`npx` are Linux-native. A Windows `npx` cannot reach a `\\wsl$\…` path (no UNC support), which is what breaks
|
|
105
|
+
`npx corvusmem …` across the boundary; running on the Linux side — where the path is a normal `/home/…` — just works.
|
|
106
|
+
|
|
103
107
|
## Usage
|
|
104
108
|
Once installed, the agent captures and recalls memory on its own — you don't do a thing. Two slash commands come with
|
|
105
109
|
it (native — no `npx`):
|
|
@@ -7,11 +7,14 @@ You are absorbing this project's **existing** knowledge into Corvus. The goal is
|
|
|
7
7
|
**Speak the user's language.** Every question, confirmation and the final report go in the language the user writes to you in (Spanish, etc.) — only this command's name and the saved `--keys` identifiers stay in English (and `--keys` should also include the user's own language).
|
|
8
8
|
|
|
9
9
|
## 1. Find the documents (deterministic — let the tool do this)
|
|
10
|
-
|
|
10
|
+
Use the memory CLI's `import`, with the **fastest local path available** — do **not** default to `npx` (it is only the fallback for an agent with nothing installed, and a Windows `npx` cannot reach a WSL project at `\\wsl$\…` because it does not support UNC paths). Use the first that applies:
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
- **Plugin** (`CLAUDE_PLUGIN_ROOT` set): `node "$CLAUDE_PLUGIN_ROOT/cli/corvusmem.mjs" import --json`
|
|
13
|
+
- **Per-project** (`.corvusmem/cli/corvusmem.mjs` exists): `node "$CLAUDE_PROJECT_DIR/.corvusmem/cli/corvusmem.mjs" import --json`
|
|
14
|
+
- **Global** (`~/.config/corvusmem/cli/corvusmem.mjs` exists): `node "<that path>" import --json`
|
|
15
|
+
- **Nothing installed** (fallback only): `npx corvusmem import --json`
|
|
16
|
+
|
|
17
|
+
> **WSL:** if the project lives in WSL, run Claude Code (and Corvus) **inside WSL** so Node is Linux-native — mixing a Windows agent with a `\\wsl$\…` path is exactly what breaks `npx`.
|
|
15
18
|
|
|
16
19
|
It returns the memory documents already in the repo in two tiers (`{ agent, docs, truncated, files: [{ tier, kind, rel, lines }] }`):
|
|
17
20
|
|
|
@@ -37,10 +40,10 @@ Keep every piece of **durable memory** — what should still be true next week:
|
|
|
37
40
|
Leave out only the **noise**: install/run steps, step-by-step how-tos, API/parameter dumps you would re-read from the doc anyway, tool tutorials, generic boilerplate, anything obvious from the code, anything transient, and anything already covered by a fact you saved. **When in doubt whether something is durable, keep it** — storage is cheap and recall only ever surfaces the few relevant facts per message, so more good facts make memory richer, never noisier.
|
|
38
41
|
|
|
39
42
|
## 3. Save each item (deterministic sink)
|
|
40
|
-
For every item worth keeping, run one command:
|
|
43
|
+
For every item worth keeping, run one command — the **same local CLI as step 1** (`node "<…>/cli/corvusmem.mjs"`), with `npx corvusmem` only as the fallback:
|
|
41
44
|
|
|
42
45
|
```
|
|
43
|
-
|
|
46
|
+
node "<corvusmem cli>" --save --dimension <family.topic> --value "<self-contained statement>" --keys "<term-en>,<term-native>" --source agente
|
|
44
47
|
```
|
|
45
48
|
|
|
46
49
|
- `family` is one of: `identity`, `preference`, `project`, `goal`, `pending`, `constraint`, `note`, `fact`, `learning`, `link`.
|
|
@@ -11,4 +11,6 @@ Run it with the **fastest local path available** — do not default to `npx` (th
|
|
|
11
11
|
- **Global install** (`~/.config/corvusmem/cli/corvusmem.mjs` exists): `node "<that path>" --cortex`
|
|
12
12
|
- **Nothing installed** (fallback only): `npx corvusmem --cortex`
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
The command writes a local HTML file and prints its path. **Open it in the user's browser right away** — don't just hand them the path. Use your browser tool to navigate to the `file://` path if you have one, otherwise the OS opener: `start "" "<path>"` on Windows, `open "<path>"` on macOS, `xdg-open "<path>"` (or `wslview "<path>"` on WSL) on Linux. Then tell the user it is open and give the path too, in case they want to reopen it.
|
|
15
|
+
|
|
16
|
+
Pick the user's language for anything you say. Add `--cliente` for a client-facing view, or `--idioma en|es` to force the language. It renders only what is actually stored; never invent memory that is not there.
|
package/cortex/cortex.mjs
CHANGED
|
@@ -245,7 +245,6 @@ const APP = String.raw`
|
|
|
245
245
|
$$('[data-t-aria]').forEach(function (e) { e.setAttribute('aria-label', t(e.getAttribute('data-t-aria'))); });
|
|
246
246
|
$$('[data-t-ph]').forEach(function (e) { e.setAttribute('placeholder', t(e.getAttribute('data-t-ph'))); });
|
|
247
247
|
$$('[data-t-title]').forEach(function (e) { e.setAttribute('title', t(e.getAttribute('data-t-title'))); });
|
|
248
|
-
$('#tema').textContent = raiz.getAttribute('data-theme') === 'light' ? t('oscuro') : t('claro');
|
|
249
248
|
$('#pie').textContent = t('pie', { f: new Date(D.generado).toLocaleString(L) }) + ' ' + (D.cliente ? t('pieCliente') : t('pieDueno'));
|
|
250
249
|
}
|
|
251
250
|
var sel = $('#idioma');
|
|
@@ -440,17 +439,10 @@ const APP = String.raw`
|
|
|
440
439
|
$('#buscar').addEventListener('input', function (e) { filtro = e.target.value.trim().toLowerCase(); limite = PAGINA; lista(); focoBusqueda(); });
|
|
441
440
|
$('#mas').addEventListener('click', function () { limite += PAGINA * 3; lista(); });
|
|
442
441
|
$('#cerrar').addEventListener('click', function () { $('#detalle').hidden = true; });
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
var oscuro = raiz.getAttribute('data-theme') === 'light';
|
|
446
|
-
raiz.setAttribute('data-theme', oscuro ? 'dark' : 'light');
|
|
447
|
-
tema.textContent = oscuro ? t('claro') : t('oscuro'); todo();
|
|
448
|
-
});
|
|
449
|
-
// Embebido en la web (mismo origen → comparte localStorage): el Cortex SIGUE el tema de la web (clave 'theme';
|
|
450
|
-
// 'light' = claro, si no oscuro) para no quedar como una caja negra sobre una página clara (ni texto ilegible en el
|
|
451
|
-
// hero transparente). Reacciona al toggle de la web por el evento 'storage'.
|
|
442
|
+
// El Cortex es OSCURO (sin modo claro ni botón de tema). Única excepción: EMBEBIDO en la web (data-solo, mismo origen
|
|
443
|
+
// → comparte localStorage), sigue el tema de la página para no quedar como una caja negra sobre una página clara.
|
|
452
444
|
function temaWeb() { try { return localStorage.getItem('theme') === 'light' ? 'light' : 'dark'; } catch (e) { return null; } }
|
|
453
|
-
function aplicarTemaWeb() { var w = temaWeb(); if (
|
|
445
|
+
function aplicarTemaWeb() { if (!raiz.hasAttribute('data-solo')) return; var w = temaWeb(); if (w) raiz.setAttribute('data-theme', w); }
|
|
454
446
|
aplicarTemaWeb();
|
|
455
447
|
window.addEventListener('storage', function (e) { if (e.key === 'theme') { aplicarTemaWeb(); todo(); } });
|
|
456
448
|
var cli = $('#cliente');
|
|
@@ -737,7 +729,7 @@ const APP = String.raw`
|
|
|
737
729
|
});
|
|
738
730
|
traducir();
|
|
739
731
|
todo();
|
|
740
|
-
|
|
732
|
+
var _b3 = $('[data-ir="3d"]'); if (_b3) _b3.click(); // arranca SIEMPRE en 3D (es la vista por defecto), no solo incrustado
|
|
741
733
|
})();
|
|
742
734
|
`;
|
|
743
735
|
|
|
@@ -786,14 +778,13 @@ export function htmlCortex(datos, { cli = null, idioma = null, soloCerebro = fal
|
|
|
786
778
|
<p class="cifras" id="cifras"></p>
|
|
787
779
|
</div>
|
|
788
780
|
<div class="mandos">
|
|
789
|
-
<span role="group" data-t-aria="vista"><button type="button" data-ir="2d" aria-pressed="
|
|
781
|
+
<span role="group" data-t-aria="vista"><button type="button" data-ir="2d" aria-pressed="false">2D</button> <button type="button" data-ir="3d" aria-pressed="true">3D</button></span>
|
|
790
782
|
${cliente ? '' : `<button type="button" id="cliente" aria-pressed="false" data-t="vistaCliente" data-t-title="vistaClienteT">${es.vistaCliente}</button>`}
|
|
791
783
|
${datos.actividad && datos.actividad.pensamientos && datos.actividad.pensamientos.length ? `<button type="button" id="piensa" aria-pressed="false" data-t="piensa" data-t-title="piensaT">${es.piensa}</button>` : ''}
|
|
792
|
-
<button type="button" id="tema">${es.claro}</button>
|
|
793
784
|
<label><span class="sr" data-t="idioma">${es.idioma}</span><select id="idioma"></select></label>
|
|
794
785
|
</div>
|
|
795
786
|
</div>
|
|
796
|
-
<div class="escenario" data-vista="
|
|
787
|
+
<div class="escenario" data-vista="3d">
|
|
797
788
|
<div class="v2d">
|
|
798
789
|
<div class="dibujo">${cerebro()}</div>
|
|
799
790
|
<p class="pista" data-t="pista">${es.pista}</p>
|