Exposes chat_gtf.yaml as live tools for Claude Desktop / Claude Code. Converts Claude.ai chat exports into structured project memory (nodes, decisions, failures, dependencies).
Mnemo has 12 tools with basic verb-noun naming (gtf_*), but critical gaps undermine quality. All tools have descriptions (10-100 chars, mostly adequate), but input schemas are present yet minimal. Most parameters lack type constraints and detailed descriptions. No output schemas documented. Error handling is absent, tools return raw exceptions rather than actionable recovery guidance. No parameter validation, no enum constraints, no pagination support. The server exposes file paths and LLM provider selection as parameters, creating security and usability risks. Tool composition is reasonable (each does one thing), but lack of structured output and error guidance makes this unsuitable for production agent use.
Capture the latest Claude Code session (.jsonl) and convert to chat text, then merge into GTF
Create a timestamped backup of the active GTF file
Delete the active GTF file and remove it from the registry
Use an LLM to enrich failure_memory entries with code patterns (code_pattern_to_avoid, safe_pattern)
Index a Claude.ai chat export (.md) into the active GTF using an LLM
List all discovered GTF files (from registry + flat scan)
Merge new data into the active GTF file (deep merge on dicts, append on lists)
No output schemas documented. Tools return raw YAML dicts or file paths without specifying structure, field types, or pagination. LLMs cannot plan downstream calls or extract required data reliably.
LLM provider and model exposed as tool parameters (gtf_enrich, gtf_index). Credentials and API keys should be injected server-side via environment variables, not passed by the agent. This risks leaking secrets into logs and prompt history.
No error handling or recovery guidance. Tools will throw raw Python exceptions (FileNotFoundError, yaml.YAMLError, etc.) instead of returning structured errors with actionable next steps. Agents cannot self-correct.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
Open a GUI project picker (tkinter) to select and load a GTF file
Read the entire active GTF file and return its YAML content
Remove entries from the registry whose files no longer exist
Switch the active GTF file to a different project
Write/update the active GTF file with new YAML content
Parameter descriptions lack format constraints and validation rules. 'path' in gtf_switch has no guidance on absolute vs relative paths, symlink handling, or permission requirements. 'failure_ids' in gtf_enrich lacks examples of valid ID format.
Destructive operations (gtf_delete, gtf_write) lack confirmation or dry-run support. An agent mistake will permanently delete or overwrite GTF files without warning. No audit trail or undo mechanism.