Cross-agent terminal memory and session management: recall, search, and resume Claude Code, Codex, Gemini, opencode, and shell sessions by directory.
termem has 8 tools with basic schemas and descriptions, but significant gaps limit production readiness. Tool names lack consistent verb prefixes (e.g., 'recall_sessions' vs 'list_sessions', 'interactive_picker' is vague). Descriptions are present but brief (avg ~60 chars, below the 194-char baseline). Parameter descriptions exist but lack detail on constraints, formats, and dependencies. No output schemas documented. Error handling and recovery guidance absent. No tool annotations (readOnlyHint/destructiveHint). The server is STDIO-only, which is a hard transport limitation.
Print a one-line session count for a directory (used by the cd hook)
Emit shell integration (zsh, bash, powershell) or an agent wrapper (claude, codex, opencode, gemini, pi)
Open the interactive TUI picker for sessions
Run the memory MCP server over stdio
List sessions for a directory with optional search filtering
Refresh the index from disk and print stats
Repoint sessions from a moved/renamed folder onto its new path
Resume a session by id or fuzzy query (default: most recent in directory)
Inconsistent naming conventions. 'recall_sessions' should be 'list_sessions'; 'interactive_picker' is vague (pick what? sessions? files?); 'mcp_server' is not an action verb. LLMs cannot infer intent from these names.
No output schemas documented. Callers cannot know what fields to expect from each tool, forcing LLMs to guess or make follow-up discovery calls. This violates the response-shaper pattern.
Parameter descriptions lack constraint details. E.g., 'limit' has no min/max bounds; 'source' lists values as comma-separated text but no enum constraint; 'target' in emit_shell_integration has no enum of valid values. LLMs will hallucinate invalid inputs.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 42 | 2026-07-28+ | v2 |
No error handling or recovery guidance. Tools like 'resume_session' and 'relink_sessions' perform state mutations but provide no guidance on failure modes, retryability, or what to do if a session is not found.
No tool annotations. Tools like 'resume_session' and 'relink_sessions' are destructive/write operations but lack readOnlyHint or destructiveHint annotations. Agents cannot distinguish safe reads from risky mutations.