omo-memory 0.1.4 → 0.1.5
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 +5 -5
- package/dist/hookTemplates.js +1 -1
- package/dist/memory.js +1 -2
- package/docs/adapter-integration.md +3 -3
- package/docs/epic-omo-memory.md +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@ It gives lazycodex, omo-on-opencode, lfg, and future OMO adapters a shared local
|
|
|
9
9
|
|
|
10
10
|
## Product shape
|
|
11
11
|
|
|
12
|
-
-
|
|
12
|
+
- Project-local DB: `<project-root>/.omo/memory/state.sqlite`
|
|
13
13
|
- Project namespacing: by git remote + project root hash
|
|
14
14
|
- Privacy default: local-only, no network sync, no secrets by design
|
|
15
15
|
- Intended adapters: Codex/lazycodex, OpenCode/OMO, GrokBuild/lfg
|
|
@@ -49,7 +49,7 @@ omo-memory init
|
|
|
49
49
|
|
|
50
50
|
## MCP registration
|
|
51
51
|
|
|
52
|
-
Register the same MCP server in every host that should read/write the
|
|
52
|
+
Register the same MCP server in every host that should read/write the current project's memory DB.
|
|
53
53
|
|
|
54
54
|
Codex:
|
|
55
55
|
|
|
@@ -63,7 +63,7 @@ Grok:
|
|
|
63
63
|
grok mcp add omo-memory -- npx -y omo-memory mcp
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
-
Both hosts use
|
|
66
|
+
Both hosts use the current project ledger at `<project-root>/.omo/memory/state.sqlite` by default. The `host` value is recorded when an adapter calls `memory_start_session`, not by installing separate servers.
|
|
67
67
|
|
|
68
68
|
## Passive setup
|
|
69
69
|
|
|
@@ -75,10 +75,10 @@ npx -y omo-memory hooks install --host all
|
|
|
75
75
|
|
|
76
76
|
This installs:
|
|
77
77
|
|
|
78
|
-
- Codex: `~/.codex/skills/omo-memory/SKILL.md
|
|
78
|
+
- Codex: `~/.codex/skills/omo-memory/SKILL.md`, a global `~/.codex/AGENTS.md` lifecycle rule, and a local Codex plugin with a `SessionStart` hook.
|
|
79
79
|
- Grok: `~/.grok/skills/omo-memory/SKILL.md`, a global `~/.grok/AGENTS.md` lifecycle rule, and a `~/.grok/hooks/` SessionStart hook.
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
The installer is idempotent. For Codex it also runs `codex plugin add omo-memory@islee23520 --json` when installing into the real home directory.
|
|
82
82
|
|
|
83
83
|
## Session bootstrap
|
|
84
84
|
|
package/dist/hookTemplates.js
CHANGED
|
@@ -84,7 +84,7 @@ try {
|
|
|
84
84
|
export const GROK_HOOK_SCRIPT = SESSION_BOOTSTRAP_SCRIPT.replace('?? "codex"', '?? "grok"').replace('?? "lazycodex"', '?? "lfg"');
|
|
85
85
|
export const CODEX_PLUGIN_JSON = `{
|
|
86
86
|
"name": "omo-memory",
|
|
87
|
-
"version": "0.1.
|
|
87
|
+
"version": "0.1.5",
|
|
88
88
|
"description": "Session-start OMO Memory bootstrap hook for Codex.",
|
|
89
89
|
"author": "islee23520",
|
|
90
90
|
"homepage": "https://github.com/islee23520/omo-memory",
|
package/dist/memory.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import Database from "better-sqlite3";
|
|
2
2
|
import { createHash, randomUUID } from "node:crypto";
|
|
3
3
|
import { mkdirSync } from "node:fs";
|
|
4
|
-
import { homedir } from "node:os";
|
|
5
4
|
import { dirname, join, resolve } from "node:path";
|
|
6
5
|
import { execFileSync } from "node:child_process";
|
|
7
6
|
import { redactSecrets, sanitizeGitRemote } from "./privacy.js";
|
|
@@ -13,7 +12,7 @@ export class PurgeConfirmationError extends Error {
|
|
|
13
12
|
}
|
|
14
13
|
const SCHEMA_VERSION = 1;
|
|
15
14
|
export function defaultDbPath() {
|
|
16
|
-
return process.env["OMO_MEMORY_DB"] ?? join(
|
|
15
|
+
return process.env["OMO_MEMORY_DB"] ?? join(resolveProjectContext().repoRoot, ".omo", "memory", "state.sqlite");
|
|
17
16
|
}
|
|
18
17
|
export function memoryPaths() {
|
|
19
18
|
return { dbPath: defaultDbPath() };
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Adapter Integration
|
|
2
2
|
|
|
3
|
-
OMO Memory is the shared local work ledger for OMO adapters. It is host-neutral: lazycodex, omo-on-opencode, lfg, and future adapters all write summaries, decisions, QA evidence, task state, and handoffs to the same local SQLite database at
|
|
3
|
+
OMO Memory is the shared local work ledger for OMO adapters. It is host-neutral: lazycodex, omo-on-opencode, lfg, and future adapters all write summaries, decisions, QA evidence, task state, and handoffs to the same project-local SQLite database at `<project-root>/.omo/memory/state.sqlite` by default.
|
|
4
4
|
|
|
5
5
|
No full transcript capture by default. Do not store API keys, tokens, `.env` contents, auth files, raw tool logs, auth headers, cookies, or any other secret-bearing material.
|
|
6
6
|
|
|
@@ -93,11 +93,11 @@ npx -y omo-memory hooks install --host all
|
|
|
93
93
|
|
|
94
94
|
Supported `--host` values:
|
|
95
95
|
|
|
96
|
-
- `codex`: installs `~/.codex/skills/omo-memory/SKILL.md
|
|
96
|
+
- `codex`: installs `~/.codex/skills/omo-memory/SKILL.md`, an idempotent OMO Memory block in `~/.codex/AGENTS.md`, and a local Codex plugin with a `SessionStart` hook.
|
|
97
97
|
- `grok`: installs `~/.grok/skills/omo-memory/SKILL.md`, an idempotent OMO Memory block in `~/.grok/AGENTS.md`, and `~/.grok/hooks/omo-memory-hooks.json` plus its SessionStart script.
|
|
98
98
|
- `all`: installs both.
|
|
99
99
|
|
|
100
|
-
The installer is idempotent and replaces only the marked `omo-memory` block in AGENTS files.
|
|
100
|
+
The installer is idempotent and replaces only the marked `omo-memory` block in AGENTS files. For Codex it also registers the local plugin with `codex plugin add omo-memory@islee23520 --json` when installing into the real home directory.
|
|
101
101
|
|
|
102
102
|
## Session Bootstrap Flow
|
|
103
103
|
|
package/docs/epic-omo-memory.md
CHANGED
|
@@ -17,7 +17,7 @@ Codegraph solves code intelligence, not work/session memory. OMO needs a separat
|
|
|
17
17
|
|
|
18
18
|
## Product direction
|
|
19
19
|
|
|
20
|
-
-
|
|
20
|
+
- Project-local DB: `<project-root>/.omo/memory/state.sqlite`
|
|
21
21
|
- Project namespace: derive from git remote + repo root hash, with branch/head metadata
|
|
22
22
|
- Local-first privacy: no cloud sync and no secret storage by default
|
|
23
23
|
- Adapter-neutral schema: `host` and `adapter` are metadata, not separate products
|
|
@@ -58,7 +58,7 @@ Codegraph solves code intelligence, not work/session memory. OMO needs a separat
|
|
|
58
58
|
|
|
59
59
|
### CLI
|
|
60
60
|
|
|
61
|
-
- `omo-memory init` creates or migrates
|
|
61
|
+
- `omo-memory init` creates or migrates `<project-root>/.omo/memory/state.sqlite`.
|
|
62
62
|
- `omo-memory session start --host grok --adapter lfg` records a session for the current project.
|
|
63
63
|
- `omo-memory event record --type decision --summary "..."` appends a project/session event.
|
|
64
64
|
- `omo-memory recent` lists recent project events.
|