docs(mempalace): document tunnel + drawer + maintenance tools, note 3.3.4 auto-tunnels#100
Merged
dylanneve1 merged 1 commit intomainfrom May 1, 2026
Merged
Conversation
….3.4 auto-tunnels The mempalace MCP server has exposed 29 tools for a while now, but the agent prompt only documented ~18 of them. Tools that were previously invisible to the model: - Drawer management: get_drawer, list_drawers, update_drawer - Cross-wing tunnels: create_tunnel, list_tunnels, delete_tunnel, follow_tunnels - Maintenance: reconnect, memories_filed_away, hook_settings - Misc: get_aaak_spec mempalace 3.3.4 also added automatic cross-wing tunnel creation when topics overlap across wings (PR #1184 upstream). Agents needed a heads-up that tunnels mostly form on their own now and the manual create/delete tools are for steering, not building from scratch. No code changes — prompt-only update. The Talon plugin is version-agnostic (shells out to the venv python), so no plugin bump is required.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The mempalace MCP server has been exposing 29 tools for a while, but
prompts/mempalace.mdonly documented ~18 of them. This PR brings the prompt up to parity with the actual tool surface and adds a heads-up about mempalace 3.3.4's new auto-tunnel behavior.What's new in the prompt
Cross-wing tunnels (expanded):
mempalace_create_tunnel— manual tunnel between (wing, room) pairsmempalace_list_tunnels— list tunnels (filterable by wing)mempalace_delete_tunnel— remove a wrong / noisy tunnelmempalace_follow_tunnels— walk outbound tunnels from a specific roomDrawer management (new section):
mempalace_get_drawer— fetch by ID after a search hitmempalace_list_drawers— paginated browse for inventory/cleanupmempalace_update_drawer— edit in place (was added in 3.2.0)Maintenance (new section):
mempalace_reconnect— force reconnect after CLI/external script writesmempalace_memories_filed_away— confirm a stop-hook checkpoint flushedmempalace_hook_settings— toggle silent-save / desktop-toastMisc:
mempalace_get_aaak_spec— AAAK closet/compression specWhy now
mempalace 3.3.4 (released 2026-05-01) makes tunnels meaningfully more useful — they now auto-form when topics overlap across wings (upstream #1184). The agent needed to know that tunnels are mostly populated automatically and the manual create/delete tools are for steering, not building from scratch.
Scope
Prompt-only. No plugin bump, no code change, no schema change. Talon's mempalace plugin shells out to the venv python and is version-agnostic — the upstream upgrade from 3.3.2 → 3.3.4 doesn't require any Talon-side change beyond
pip install --upgrade mempalacein the venv.Test plan
npm run lint— 9 pre-existing warnings, 0 errors (no changes)npm test -- --run— 1367/1367 passingmempalace_create_tunnel,mempalace_get_drawer,mempalace_list_drawers,mempalace_update_drawer,mempalace_follow_tunnels,mempalace_reconnect,mempalace_memories_filed_awayall respond on the live palace