Skip to content

Memories

wtf remembers your preferences. Things like "I use vim" or "I prefer npm over yarn". These memories help it give better, more personalized suggestions.

What Gets Remembered?

  • Editor preferences: vim, emacs, VS Code, etc.
  • Tool preferences: npm vs yarn, pip vs poetry, etc.
  • Environment details: OS, timezone, common directories
  • Workflow patterns: How you typically work

How to Use Memories

Teaching wtf Your Preferences

Just tell it naturally - the AI understands what you mean:

# Single preference
$ wtf remember I use emacs for editing

# Multiple preferences at once
$ wtf remember I live in San Francisco and prefer emacs and use pytest for tests

The AI will save each fact separately. No special syntax or commands to memorize.

Viewing Your Memories

Ask naturally - any phrasing works:

$ wtf what do you remember about me?

$ wtf show my preferences

$ wtf list your memories of me

Forgetting Things

Tell it what to forget:

$ wtf forget about my editor

$ wtf delete my location preference

$ wtf forget everything

All memory operations work via natural language - no slash commands or special syntax needed.

How Memories Work

When you ask wtf for help, it includes your memories in the context:

$ wtf how do I run my tests?

# Without memories:
→ Suggests: python -m unittest

# With memory (test_framework: pytest):
→ Suggests: pytest

The AI uses memories to: - Skip questions it already knows the answer to - Suggest tools you actually use - Format output the way you prefer

Storage

Memories are stored in ~/.config/wtf/memories.json:

{
  "editor": {
    "value": "emacs",
    "confidence": 1.0,
    "learned_from": "explicit_instruction",
    "timestamp": "2024-01-15T10:30:00Z"
  },
  "test_framework": {
    "value": "pytest",
    "confidence": 1.0,
    "learned_from": "explicit_instruction",
    "timestamp": "2024-01-15T10:35:00Z"
  }
}

Confidence Scores

Some memories have confidence scores:

  • 1.0: Explicitly told (you said "remember I use vim")
  • 0.8: Strong inference (you always use pytest)
  • 0.5: Weak inference (you used yarn once)

Lower confidence memories may be double-checked before being used.

Privacy

  • Memories are stored locally only in ~/.config/wtf/
  • They're sent to the AI provider as context with your queries
  • No memories are sent to wtf servers (there are no wtf servers)

Examples

Workflow Preferences

$ wtf remember I always rebase instead of merge
$ wtf remember I use Docker for all my projects
$ wtf remember I work on microservices

Then when you ask:

$ wtf how do I update my feature branch?
→ Suggests: git pull --rebase origin main
# (Instead of git merge)

Environment Details

$ wtf remember I use zsh on macOS
$ wtf remember my projects are in ~/code/
$ wtf remember I use pyenv for Python

Clearing Everything

Need a fresh start?

$ wtf --reset

This deletes all config, including memories.

Tips

Be specific: 

✓ Good: "remember I use pytest with coverage"
✗ Vague: "remember I like testing"

Update when things change: 

$ wtf remember I switched to pnpm from npm

Don't over-specify: 

✗ Too much: "remember I use vim with these exact plugins..."
✓ Enough: "remember I use vim"

Next Steps