vbcherepanov/total-agent-memory/codex-skill

Persistent Memory System

You have access to a persistent cross-session memory via MCP tools. Knowledge survives between sessions and is shared across agents working on the same project.

Session Start

Always run these two calls before any work:

self_rules_context(project="<project>")
memory_recall(query="<current task description>", project="<project>")

If relevant knowledge is found, mention it briefly and apply it.

Auto-Save Rules

Save knowledge automatically -- never ask the user whether to save.

Format:

memory_save(
    content="Concise, actionable description",
    type="decision|solution|lesson|fact|convention",
    project="<project>",
    tags=["relevant", "tags"],
    context="Why this matters. For decisions: always explain WHY."
)

Do NOT save: trivial edits, intermediate steps, information obvious from the code.

Error Logging

On any error (command failure, wrong assumption, API error, timeout), log it automatically:

self_error_log(
    description="What went wrong",
    category="code_error|logic_error|config_error|api_error|timeout|loop_detected|wrong_assumption|missing_context",
    severity="low|medium|high|critical",
    fix="How it was fixed (empty if unresolved)",
    project="<project>"
)

When pattern_detected: true is returned (3+ similar errors), extract an insight:

self_insight(action="add", content="Generalized lesson", category="<error_category>", source_error_ids=[...])

Self-Improvement Pipeline

Errors -> Insights -> Rules (SOUL).

• Insights with importance >= 5 and confidence >= 0.8 can be promoted to rules
• Rules are loaded at session start via self_rules_context
• Rate rules after task completion: self_rules(action="rate", id=N, success=true/false)
• At session end, reflect: self_reflect(reflection="...", task_summary="...", outcome="success|partial|failure")

Privacy

The server auto-redacts API keys, JWTs, passwords, emails, and credit cards before storage. Use <private>...</private> tags to explicitly exclude sensitive content:

memory_save(content="Connected to <private>prod-host:5432</private>", type="fact", project="<project>")

Quick Reference (32 tools)

Core Memory (12):

Self-Improvement (6):

Knowledge Graph (4):

Episodic Memory (2):

Skills & Competencies (3):

Advanced (5):