fix(website): correct false claims and stale numbers in live docs
- Landing: replace nonexistent `mempalace remember` CLI demo with real
`mempalace mine ./notes`
- Landing: soften unverifiable absolutes ("forever available",
"100% recall by design", "<50 ms", "90%+ compression",
"two-thousand-year-old", "tens of thousands of entries")
- MCP tool count: 19 → 29 across mcp-integration, claude-code, openclaw,
and modules; expand tool overview with Drawers, Tunnels, and System
categories to match mcp_server.py
- Wake-up token range: ~170–900 → ~600–900 in cli/api-reference/python-api
to match cli.py help text and concept docs
- Gemini CLI: move `--scope user` before target name and add `--`
separator so `-m mempalace.mcp_server` isn't parsed as Gemini flags
This commit is contained in:
Igor Lins e Silva
@@ -415,8 +415,8 @@ onBeforeUnmount(() => {
|
||||
</h1>
|
||||
<p class="lede">
|
||||
An AI that forgets cannot know you. MemPalace keeps every word you have
|
||||
shared — verbatim, on your machine, forever available. One hundred
|
||||
percent recall by design.
|
||||
shared — verbatim, on your machine, permanent. Designed for total
|
||||
recall.
|
||||
</p>
|
||||
<form class="waitlist waitlist-hero" data-source="hero" novalidate>
|
||||
<div class="waitlist-head">
|
||||
@@ -520,7 +520,7 @@ onBeforeUnmount(() => {
|
||||
<article class="demo-pane demo-remember">
|
||||
<header>
|
||||
<span class="pane-tag">with mempalace</span>
|
||||
<span class="pane-meta">verbatim · retrieved <<em>50 ms</em></span>
|
||||
<span class="pane-meta">verbatim · retrieved <em>instantly</em></span>
|
||||
</header>
|
||||
<div class="chat" data-pane="remember" aria-live="polite"></div>
|
||||
</article>
|
||||
@@ -539,10 +539,10 @@ onBeforeUnmount(() => {
|
||||
</h2>
|
||||
</div>
|
||||
<p class="lede">
|
||||
A two-thousand-year-old memory technique, reworked for a machine.
|
||||
Broad categories nest time-based groupings; time-based groupings hold
|
||||
verbatim drawers. A symbolic index lets the model scan thousands of
|
||||
drawers in a single breath and open only the ones it needs.
|
||||
An ancient memory technique, reworked for a machine. Broad categories
|
||||
nest time-based groupings; time-based groupings hold verbatim drawers.
|
||||
A symbolic index lets the model scan thousands of drawers in a single
|
||||
pass and open only the ones it needs.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
@@ -609,8 +609,8 @@ onBeforeUnmount(() => {
|
||||
</h2>
|
||||
<p class="lede">
|
||||
The content stays verbatim — always. The <em>index</em> above it is written
|
||||
in AAAK: a dense symbolic dialect an LLM can scan at a glance. Tens of
|
||||
thousands of entries, one pass, exact drawer located.
|
||||
in AAAK: a dense symbolic dialect an LLM can scan at a glance. Thousands
|
||||
of entries, one pass, exact drawer located.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
@@ -657,8 +657,8 @@ onBeforeUnmount(() => {
|
||||
</div>
|
||||
|
||||
<p class="dialect-caption">
|
||||
Ninety-plus percent compression on the pointer layer. One hundred percent
|
||||
fidelity on the content layer. You get speed without ever losing a word.
|
||||
Dense compression on the pointer layer. Full fidelity on the content
|
||||
layer. You get speed without ever losing a word.
|
||||
</p>
|
||||
</section>
|
||||
|
||||
@@ -760,7 +760,7 @@ onBeforeUnmount(() => {
|
||||
<span class="ok"> ✓</span> palace created at <span class="dim">~/.mempalace</span>
|
||||
<span class="ok"> ✓</span> hooks registered <span class="dim">(stop, precompact)</span>
|
||||
<span class="ok"> ✓</span> knowledge graph initialized
|
||||
<span class="prompt">$</span> mempalace remember <span class="dim">"memory is identity."</span>
|
||||
<span class="prompt">$</span> mempalace mine <span class="dim">./notes</span>
|
||||
<span class="ok"> ✓</span> filed · <span class="c">W-001/R-01/D-001</span></pre>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ Restart Claude Code, then type `/skills` to verify "mempalace" appears.
|
||||
|
||||
With the plugin installed, Claude Code automatically:
|
||||
- Starts the MemPalace MCP server on launch
|
||||
- Has access to all 19 tools
|
||||
- Has access to all 29 tools
|
||||
- Learns the AAAK dialect and memory protocol from the `mempalace_status` response
|
||||
- Searches the palace before answering questions about past work
|
||||
|
||||
|
||||
@@ -40,12 +40,14 @@ You can optionally create or edit:
|
||||
Register MemPalace as an MCP server:
|
||||
|
||||
```bash
|
||||
gemini mcp add mempalace /absolute/path/to/mempalace/.venv/bin/python3 \
|
||||
-m mempalace.mcp_server --scope user
|
||||
gemini mcp add --scope user mempalace \
|
||||
-- /absolute/path/to/mempalace/.venv/bin/python -m mempalace.mcp_server
|
||||
```
|
||||
|
||||
::: warning
|
||||
Use the **absolute path** to the Python binary to ensure it works from any directory.
|
||||
Use the **absolute path** to the Python binary so the server starts from any
|
||||
working directory. The `--` separator prevents Gemini from parsing
|
||||
`-m mempalace.mcp_server` as its own flags.
|
||||
:::
|
||||
|
||||
## Enable Auto-Saving
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# MCP Integration
|
||||
|
||||
MemPalace provides 19 tools through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), giving any MCP-compatible AI full read/write access to your palace.
|
||||
MemPalace provides 29 tools through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), giving any MCP-compatible AI full read/write access to your palace.
|
||||
|
||||
## Setup
|
||||
|
||||
@@ -24,7 +24,7 @@ claude mcp add mempalace -- python -m mempalace.mcp_server
|
||||
claude mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace
|
||||
```
|
||||
|
||||
Now your AI has all 19 tools available. Ask it anything:
|
||||
Now your AI has all 29 tools available. Ask it anything:
|
||||
|
||||
> *"What did we decide about auth last month?"*
|
||||
|
||||
@@ -66,11 +66,19 @@ This protocol is what turns storage into memory — the AI knows to verify befor
|
||||
| `mempalace_check_duplicate` | Check before filing |
|
||||
| `mempalace_get_aaak_spec` | AAAK dialect reference |
|
||||
|
||||
### Drawers (read)
|
||||
|
||||
| Tool | What |
|
||||
|------|------|
|
||||
| `mempalace_get_drawer` | Fetch a single drawer by ID |
|
||||
| `mempalace_list_drawers` | List drawers with pagination |
|
||||
|
||||
### Palace (write)
|
||||
|
||||
| Tool | What |
|
||||
|------|------|
|
||||
| `mempalace_add_drawer` | File verbatim content |
|
||||
| `mempalace_update_drawer` | Update drawer content or metadata |
|
||||
| `mempalace_delete_drawer` | Remove by ID |
|
||||
|
||||
### Knowledge Graph
|
||||
@@ -91,6 +99,15 @@ This protocol is what turns storage into memory — the AI knows to verify befor
|
||||
| `mempalace_find_tunnels` | Find rooms bridging two wings |
|
||||
| `mempalace_graph_stats` | Graph connectivity overview |
|
||||
|
||||
### Tunnels
|
||||
|
||||
| Tool | What |
|
||||
|------|------|
|
||||
| `mempalace_create_tunnel` | Create an explicit cross-wing tunnel |
|
||||
| `mempalace_list_tunnels` | List all explicit tunnels |
|
||||
| `mempalace_delete_tunnel` | Delete an explicit tunnel |
|
||||
| `mempalace_follow_tunnels` | Follow tunnels out from a room |
|
||||
|
||||
### Agent Diary
|
||||
|
||||
| Tool | What |
|
||||
@@ -98,4 +115,12 @@ This protocol is what turns storage into memory — the AI knows to verify befor
|
||||
| `mempalace_diary_write` | Write AAAK diary entry |
|
||||
| `mempalace_diary_read` | Read recent diary entries |
|
||||
|
||||
### System
|
||||
|
||||
| Tool | What |
|
||||
|------|------|
|
||||
| `mempalace_hook_settings` | Get or set hook behavior |
|
||||
| `mempalace_memories_filed_away` | Check whether the last checkpoint was saved |
|
||||
| `mempalace_reconnect` | Force reconnect to the database |
|
||||
|
||||
For detailed schemas and parameters, see [MCP Tools Reference](/reference/mcp-tools).
|
||||
|
||||
@@ -27,7 +27,7 @@ Or by directly editing your OpenClaw configuration:
|
||||
|
||||
## How It Works
|
||||
|
||||
Once connected, OpenClaw agents receive all 19 tools along with the **Memory Protocol**—a strict behavioral guide indicating they should:
|
||||
Once connected, OpenClaw agents receive all 29 tools along with the **Memory Protocol**—a strict behavioral guide indicating they should:
|
||||
1. **Never guess**: Query `mempalace_search` or `mempalace_kg_query` before confidently answering.
|
||||
2. **Keep an agent diary**: Maintain continuity between sessions by writing to `mempalace_diary_write`.
|
||||
3. **Manage the Knowledge Graph**: Update declarative facts when things change using `mempalace_kg_add` and `mempalace_kg_invalidate`.
|
||||
|
||||
@@ -108,7 +108,7 @@ Unified 4-layer interface.
|
||||
|
||||
| Method | Parameters | Returns | Description |
|
||||
|--------|-----------|---------|-------------|
|
||||
| `wake_up(wing=None)` | Optional wing | `str` | L0 + L1 context (~170–900 tokens) |
|
||||
| `wake_up(wing=None)` | Optional wing | `str` | L0 + L1 context (~600–900 tokens) |
|
||||
| `recall(wing, room, n_results=10)` | Filters | `str` | L2 on-demand retrieval |
|
||||
| `search(query, wing, room, n_results=5)` | Query + filters | `str` | L3 deep search |
|
||||
| `status()` | — | `dict` | All layer status info |
|
||||
|
||||
@@ -89,7 +89,7 @@ mempalace split <dir> --output-dir ~/split-output/
|
||||
|
||||
## `mempalace wake-up`
|
||||
|
||||
Show L0 + L1 wake-up context (~170–900 tokens).
|
||||
Show L0 + L1 wake-up context (~600–900 tokens).
|
||||
|
||||
```bash
|
||||
mempalace wake-up
|
||||
|
||||
@@ -9,7 +9,7 @@ mempalace/
|
||||
├── README.md ← project documentation
|
||||
├── mempalace/ ← core package
|
||||
│ ├── cli.py ← CLI entry point
|
||||
│ ├── mcp_server.py ← MCP server (19 tools)
|
||||
│ ├── mcp_server.py ← MCP server (29 tools)
|
||||
│ ├── knowledge_graph.py ← temporal entity graph
|
||||
│ ├── palace_graph.py ← room navigation graph
|
||||
│ ├── dialect.py ← AAAK compression
|
||||
@@ -56,7 +56,7 @@ Argparse-based CLI with subcommands: `init`, `mine`, `split`, `search`, `compres
|
||||
|
||||
### `mcp_server.py` — MCP Server
|
||||
|
||||
JSON-RPC over stdin/stdout. Implements the MCP protocol with 19 tools covering palace read/write, knowledge graph, navigation, and agent diary operations. Includes the Memory Protocol and AAAK Spec in status responses.
|
||||
JSON-RPC over stdin/stdout. Implements the MCP protocol with 29 tools covering palace read/write, drawer CRUD, knowledge graph, navigation, tunnels, agent diary, and system operations. Includes the Memory Protocol and AAAK Spec in status responses.
|
||||
|
||||
### `searcher.py` — Semantic Search
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ from mempalace.layers import MemoryStack
|
||||
stack = MemoryStack() # uses default paths from MempalaceConfig
|
||||
|
||||
# Wake-up: L0 (identity) + L1 (essential story)
|
||||
context = stack.wake_up(wing="myapp") # ~170-900 tokens
|
||||
context = stack.wake_up(wing="myapp") # ~600-900 tokens
|
||||
|
||||
# On-demand: L2 retrieval
|
||||
recall = stack.recall(wing="myapp", room="auth", n_results=10)
|
||||
|
||||
Reference in New Issue
Block a user