agent-recall-mcp 3.3.2 → 3.3.3

package/README.md

@@ -15,6 +15,26 @@
 
 ---
 
+## `/arsave` — Save Everything in One Shot
+
+> **Two commands. That's all you need.**
+
+| Command | When | What it does |
+|---------|------|-------------|
+| **`/arsave`** | End of session | Write journal + consolidate to palace + update awareness + optional git push |
+| **`/arstart`** | Start of session | Recall cross-project insights + walk palace + load context |
+
+Type `/arsave` after a long project session. Everything gets saved. Type `/arstart` next time. Everything loads back.
+
+```bash
+# Install commands (one-time)
+mkdir -p ~/.claude/commands
+curl -o ~/.claude/commands/arsave.md https://raw.githubusercontent.com/Goldentrii/AgentRecall/main/commands/arsave.md
+curl -o ~/.claude/commands/arstart.md https://raw.githubusercontent.com/Goldentrii/AgentRecall/main/commands/arstart.md
+```
+
+---
+
 ## What Is AgentRecall?
 
 AgentRecall is an **MCP server** (Model Context Protocol) that gives AI agents persistent memory, cross-project insight recall, and a self-compounding awareness system. It works with Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible agent.
@@ -52,6 +72,9 @@ claude mcp add agent-recall -- npx -y agent-recall-mcp
 
 # Windsurf — ~/.codeium/windsurf/mcp_config.json
 { "mcpServers": { "agent-recall": { "command": "npx", "args": ["-y", "agent-recall-mcp"] } } }
+
+# Codex — ~/.codex/config.toml (or .codex/config.toml for project-scoped)
+codex mcp add agent-recall -- npx -y agent-recall-mcp
 ```
 
 **Skill (Claude Code only):**
@@ -65,7 +88,7 @@ curl -o ~/.claude/skills/agent-recall/SKILL.md \
 
 ## How an Agent Uses AgentRecall
 
-### Session Start
+### Session Start (`/arstart`)
 ```
 1. recall_insight(context="current task description")   → relevant cross-project insights
 2. palace_walk(depth="active")                           → project context + awareness
@@ -204,6 +227,7 @@ The gap between human intent and agent understanding is structural — different
 | Agent | MCP | Skill | Notes |
 |-------|:---:|:-----:|-------|
 | Claude Code | ✅ | ✅ | Full support — MCP + SKILL.md |
+| OpenAI Codex | ✅ | — | `codex mcp add` — config.toml |
 | Cursor | ✅ | ⚡ | MCP via .cursor/mcp.json |
 | VS Code (Copilot) | ✅ | — | MCP via .vscode/mcp.json |
 | Windsurf | ✅ | ⚡ | MCP via mcp_config.json |
@@ -243,7 +267,7 @@ Built by [tongwu](https://github.com/Goldentrii).
 
 - Issues & feedback: [GitHub Issues](https://github.com/Goldentrii/AgentRecall/issues)
 - Email: tongwu0824@gmail.com
-- Protocol spec: [docs/intelligent-distance-protocol.md](docs/intelligent-distance-protocol.md)
+- Protocol spec: [docs/intelligent-distance-protocol.md](https://github.com/Goldentrii/AgentRecall/blob/main/docs/intelligent-distance-protocol.md)
 
 MIT License.
 
@@ -281,6 +305,9 @@ claude mcp add agent-recall -- npx -y agent-recall-mcp
 
 # VS Code — .vscode/mcp.json
 { "servers": { "agent-recall": { "command": "npx", "args": ["-y", "agent-recall-mcp"] } } }
+
+# Codex — ~/.codex/config.toml
+codex mcp add agent-recall -- npx -y agent-recall-mcp
 ```
 
 **Claude Code 技能安装：**
@@ -294,7 +321,7 @@ curl -o ~/.claude/skills/agent-recall/SKILL.md \
 
 ## 智能体使用流程
 
-### 会话开始
+### 会话开始 (`/arstart`)
 ```
 1. recall_insight(context="当前任务描述")    → 跨项目相关洞察
 2. palace_walk(depth="active")               → 项目上下文 + 感知摘要
@@ -430,6 +457,6 @@ curl -o ~/.claude/skills/agent-recall/SKILL.md \
 
 - Issues & 反馈：[GitHub Issues](https://github.com/Goldentrii/AgentRecall/issues)
 - 邮箱：tongwu0824@gmail.com
-- 协议规范：[docs/intelligent-distance-protocol.md](docs/intelligent-distance-protocol.md)
+- 协议规范：[docs/intelligent-distance-protocol.md](https://github.com/Goldentrii/AgentRecall/blob/main/docs/intelligent-distance-protocol.md)
 
 MIT 许可证。

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared types, interfaces, and constants for agent-recall-mcp.
  */
-export declare const VERSION = "3.3.2";
+export declare const VERSION = "3.3.3";
 export declare const JOURNAL_ROOT: string;
 export declare const LEGACY_ROOT: string;
 export declare const SECTION_HEADERS: Record<string, string>;

package/dist/types.js

@@ -6,7 +6,7 @@ import * as os from "node:os";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-export const VERSION = "3.3.2";
+export const VERSION = "3.3.3";
 export const JOURNAL_ROOT = process.env.AGENT_RECALL_ROOT || path.join(os.homedir(), ".agent-recall");
 export const LEGACY_ROOT = path.join(os.homedir(), ".claude", "projects");
 export const SECTION_HEADERS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-recall-mcp",
-  "version": "3.3.2",
+  "version": "3.3.3",
   "description": "Memory Palace for AI agents — room-based knowledge organization with fan-out cross-referencing, salience scoring, and Obsidian-compatible output",
   "type": "module",
   "main": "dist/index.js",