@suwujs/codex-vault 0.3.3 → 0.4.0

package/README.md

@@ -113,7 +113,7 @@ User-invoked skills — the agent suggests them, but only executes when you expl
 | `/ingest` | Process a source document into wiki pages with cross-links |
 | `/recall` | On-demand memory retrieval — search the vault for a topic and synthesize |
 
-The classify hook detects intent (decision, win, project update, query, ingest) and suggests the right skill. You decide whether to run it — the agent never auto-writes vault notes.
+The classify hook detects intent (decision, win, project update, query, ingest) and suggests the right skill. By default, you decide whether to run it (**suggest mode**). Set `{"classify_mode": "auto"}` in `vault/.codex-vault/config.json` to have the agent execute skills automatically (**auto mode**).
 
 Claude Code uses `/skill-name`, Codex CLI uses `$skill-name`. Both read from their respective `.claude/skills/` and `.codex/skills/` directories.
 
@@ -163,12 +163,22 @@ See [docs/usage.md](docs/usage.md) — 7 real scenarios from first session to pr
 | Your goals | Edit `brain/North Star.md` |
 | New note types | Add templates to `templates/`, update `plugin/instructions.md` |
 | More signals | Add patterns to `plugin/hooks/classify-message.py` |
+| Auto-execute skills | Set `{"classify_mode": "auto"}` in `vault/.codex-vault/config.json` |
 | New agent | Add hooks and skills in `plugin/` ([guide](docs/adding-an-agent.md)) |
 
+## CLI
+
+```bash
+npx @suwujs/codex-vault init        # Install vault + hooks into current project
+npx @suwujs/codex-vault upgrade     # Upgrade hooks and skills (preserves vault data)
+npx @suwujs/codex-vault uninstall   # Remove hooks and skills (preserves vault data)
+```
+
 ## Requirements
 
 - Git
 - Python 3
+- Node.js >= 18 (for CLI)
 - One of: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex CLI](https://github.com/openai/codex)
 - Optional: [Obsidian](https://obsidian.md) (for graph view, backlinks, visual browsing)
 

package/README.zh-CN.md

@@ -146,10 +146,25 @@ vault/
 4. **图优先** — 目录按用途分组，`[[wikilinks]]` 按语义分组。链接是主要的组织工具。
 5. **面向未来** — 即使模型有了内建记忆，vault 仍然有价值：可审计、可迁移、git 追踪的本地存储。
 
+## CLI
+
+```bash
+npx @suwujs/codex-vault init        # 安装 vault + hooks 到当前项目
+npx @suwujs/codex-vault upgrade     # 升级 hooks 和 skills（保留 vault 数据）
+npx @suwujs/codex-vault uninstall   # 移除 hooks 和 skills（保留 vault 数据）
+```
+
+## 配置
+
+| 配置项 | 文件 | 说明 |
+|--------|------|------|
+| 自动执行 skills | `vault/.codex-vault/config.json` | `{"classify_mode": "auto"}` — 检测到意图后自动执行对应 skill，而非建议 |
+
 ## 依赖
 
 - Git
 - Python 3
+- Node.js >= 18（CLI 安装用）
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 或 [Codex CLI](https://github.com/openai/codex)（二选一）
 - 可选：[Obsidian](https://obsidian.md)（图谱视图、反向链接、可视化浏览）
 

package/bin/cli.js

@@ -64,12 +64,19 @@ function assertBash() {
 function runInit() {
   assertBash();
 
-  // Check if already installed
+  // Check if already installed (including legacy codex-mem)
   const versionFile = path.join(process.cwd(), 'vault', '.codex-vault', 'version');
+  const legacyVersionFile = path.join(process.cwd(), 'vault', '.codex-mem', 'version');
   if (fs.existsSync(versionFile)) {
     const installed = fs.readFileSync(versionFile, 'utf8').trim();
     console.log(`codex-vault v${installed} is already installed in this directory.`);
-    console.log('To reinstall, remove vault/.codex-vault/version first.');
+    console.log('Run "codex-vault upgrade" to update, or remove vault/.codex-vault/version to reinstall.');
+    return;
+  }
+  if (fs.existsSync(legacyVersionFile)) {
+    const installed = fs.readFileSync(legacyVersionFile, 'utf8').trim();
+    console.log(`Legacy codex-mem v${installed} detected.`);
+    console.log('Run "codex-vault uninstall" first, then "codex-vault init".');
     return;
   }
 
@@ -98,13 +105,19 @@ function runInit() {
 function cmdUpgrade() {
   assertBash();
 
-  // Check if installed
+  // Check if installed (including legacy codex-mem)
   const versionFile = path.join(process.cwd(), 'vault', '.codex-vault', 'version');
-  if (!fs.existsSync(versionFile)) {
+  const legacyVersionFile = path.join(process.cwd(), 'vault', '.codex-mem', 'version');
+  if (!fs.existsSync(versionFile) && !fs.existsSync(legacyVersionFile)) {
     console.error('codex-vault is not installed in this directory.');
     console.error('Run "codex-vault init" first.');
     process.exit(1);
   }
+  if (!fs.existsSync(versionFile) && fs.existsSync(legacyVersionFile)) {
+    console.error('Legacy codex-mem installation detected.');
+    console.error('Run "codex-vault uninstall" first, then "codex-vault init".');
+    process.exit(1);
+  }
 
   const installedVersion = fs.readFileSync(versionFile, 'utf8').trim();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suwujs/codex-vault",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Persistent knowledge vault for LLM agents (Claude Code, Codex CLI)",
   "license": "MIT",
   "repository": {

package/plugin/VERSION

@@ -1 +1 @@
-0.3.3
+0.4.0

package/plugin/hooks/session-start.sh

@@ -20,6 +20,38 @@ if [ ! -f "Home.md" ] && [ ! -d "brain/" ]; then
   fi
 fi
 
+# --- Visible banner (stderr → user terminal) ---
+{
+  echo ""
+  echo "  ╭─────────────────────────────────────╮"
+  echo "  │  📚 Codex-Vault · Session Context   │"
+  echo "  ├─────────────────────────────────────┤"
+
+  # North Star preview — extract first non-empty bullet under "## Current Focus"
+  if [ -f "brain/North Star.md" ]; then
+    GOAL=$(sed -n '/^## Current Focus/,/^## /{/^- ./{s/^- //;p;q;};}' "brain/North Star.md" | cut -c1-40)
+    [ -n "$GOAL" ] && echo "  │  🎯 $GOAL" || echo "  │  🎯 (set goals in North Star.md)"
+  else
+    echo "  │  🎯 (create brain/North Star.md)"
+  fi
+
+  # Active work count
+  WORK_COUNT=$(find work/active -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+  echo "  │  📋 $WORK_COUNT active project(s)"
+
+  # Uncommitted changes count
+  CHANGE_COUNT=$(git status --short -- . 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$CHANGE_COUNT" -gt 0 ]; then
+    echo "  │  ✏️  $CHANGE_COUNT uncommitted change(s)"
+  else
+    echo "  │  ✅ working tree clean"
+  fi
+
+  echo "  ╰─────────────────────────────────────╯"
+  echo ""
+} >&2
+
+# --- Full context (stdout → agent) ---
 echo "## Session Context"
 echo ""
 echo "### Date"

package/vault/.codex-vault/hooks/session-start.sh

@@ -20,6 +20,38 @@ if [ ! -f "Home.md" ] && [ ! -d "brain/" ]; then
   fi
 fi
 
+# --- Visible banner (stderr → user terminal) ---
+{
+  echo ""
+  echo "  ╭─────────────────────────────────────╮"
+  echo "  │  📚 Codex-Vault · Session Context   │"
+  echo "  ├─────────────────────────────────────┤"
+
+  # North Star preview — extract first non-empty bullet under "## Current Focus"
+  if [ -f "brain/North Star.md" ]; then
+    GOAL=$(sed -n '/^## Current Focus/,/^## /{/^- ./{s/^- //;p;q;};}' "brain/North Star.md" | cut -c1-40)
+    [ -n "$GOAL" ] && echo "  │  🎯 $GOAL" || echo "  │  🎯 (set goals in North Star.md)"
+  else
+    echo "  │  🎯 (create brain/North Star.md)"
+  fi
+
+  # Active work count
+  WORK_COUNT=$(find work/active -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+  echo "  │  📋 $WORK_COUNT active project(s)"
+
+  # Uncommitted changes count
+  CHANGE_COUNT=$(git status --short -- . 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$CHANGE_COUNT" -gt 0 ]; then
+    echo "  │  ✏️  $CHANGE_COUNT uncommitted change(s)"
+  else
+    echo "  │  ✅ working tree clean"
+  fi
+
+  echo "  ╰─────────────────────────────────────╯"
+  echo ""
+} >&2
+
+# --- Full context (stdout → agent) ---
 echo "## Session Context"
 echo ""
 echo "### Date"
@@ -40,12 +72,12 @@ echo "### Recent Changes"
 COMMITS_48H=$(git log --oneline --since="48 hours ago" --no-merges 2>/dev/null | wc -l | tr -d ' ')
 if [ "$COMMITS_48H" -gt 0 ]; then
   echo "(last 48 hours)"
-  git log --oneline --since="48 hours ago" --no-merges 2>/dev/null | head -15
+  git log --oneline --since="48 hours ago" --no-merges 2>/dev/null | head -15 || true
 else
   COMMITS_7D=$(git log --oneline --since="7 days ago" --no-merges 2>/dev/null | wc -l | tr -d ' ')
   if [ "$COMMITS_7D" -gt 0 ]; then
     echo "(nothing in 48h — showing last 7 days)"
-    git log --oneline --since="7 days ago" --no-merges 2>/dev/null | head -15
+    git log --oneline --since="7 days ago" --no-merges 2>/dev/null | head -15 || true
   else
     echo "(nothing recent — showing last 5 commits)"
     git log --oneline -5 --no-merges 2>/dev/null || echo "(no git history)"
@@ -84,7 +116,7 @@ echo ""
 
 # Uncommitted changes — shows agent what's in-flight
 echo "### Uncommitted Changes"
-CHANGES=$(git status --short -- . 2>/dev/null | head -20)
+CHANGES=$(git status --short -- . 2>/dev/null | head -20 || true)
 if [ -n "$CHANGES" ]; then
   echo "$CHANGES"
 else