Memory search has always been about finding what you need. With --topics, you could specify what you wanted to find. But sometimes the clearest way to express what you're looking for is by saying what you're not looking for.

Today we're introducing --exclude-topics—the complement to topic filtering that gives you complete control over your search results.

The Power of Exclusion

Consider these scenarios:

Multi-context workflows: You use MemNexus across different contexts—deep work sessions, quick lookups, automated integrations. Each context produces different types of memories with different topics. When searching, you might want to focus on just one context.

Team collaboration: Your team tags memories differently. Project leads use planning and strategy. Developers use implementation and debugging. When you need implementation details, excluding planning discussions gets you there faster.

Temporal focus: You've been working on a feature for weeks. Early exploration memories are tagged research. Later work is tagged implementation. When debugging, you want the implementation details without wading through early brainstorming.

How It Works

The --exclude-topics filter removes any memory that has any of the specified topics:

# Focus on implementation, skip research phase
mx memories search --query "authentication" --exclude-topics "research,brainstorming"

# Find decisions without the surrounding discussion
mx memories search --query "API design" --exclude-topics "discussion,meeting-notes"

# Combine inclusion and exclusion for precise results
mx memories search --query "payment system" --topics "implementation" --exclude-topics "deprecated"

The filter is applied server-side, keeping searches fast regardless of how many memories you're filtering.

Include vs. Exclude: When to Use Each

Use --topics (include) when:

You know exactly what category you want
You're searching within a specific project or domain
You want to narrow to a known set of topics

mx memories search --query "database" --topics "implementation,completed"

Use --exclude-topics when:

You want everything except certain categories
You're filtering out a specific context or phase
The exclusion list is shorter than the inclusion list

mx memories search --query "database" --exclude-topics "deprecated,archived"

Use both when:

You need precise control over a complex memory landscape
You want a specific category but not a subset of it

mx memories search --query "auth" --topics "implementation" --exclude-topics "v1,legacy"

Pairs With Timeline Mode

The --exclude-topics filter works beautifully with our --timeline flag for focused chronological views:

mx memories search --query "payment feature" --timeline --exclude-topics "meeting-notes"

This gives you a clean timeline of the actual work—decisions made, code written, problems solved—without interleaved meeting summaries.

Topic Strategy for Teams

To get the most from topic filtering, consider establishing topic conventions:

Context topics:

deep-work - Focused implementation sessions
quick-ref - Reference lookups and quick answers
meeting-notes - Captured during discussions
research - Exploration and investigation

Phase topics:

planning - Design and architecture
implementation - Active development
review - Code review and feedback
completed - Finished work

Status topics:

active - Current priorities
archived - Historical reference
deprecated - Superseded approaches

With consistent tagging, filtering becomes powerful:

# What's actively being worked on?
mx memories search --query "Q1 roadmap" --topics "active" --exclude-topics "archived"

# Implementation details without planning overhead
mx memories search --query "auth service" --exclude-topics "planning,meeting-notes"

Common Patterns

Focus on Recent Decisions

mx memories search --query "architecture" --recent 7d --exclude-topics "discussion"

Implementation Without Legacy Context

mx memories search --query "payment API" --topics "implementation" --exclude-topics "v1,deprecated"

Timeline Without Interruptions

mx memories search --query "feature launch" --timeline --exclude-topics "standup,sync"

Project History, Curated

mx memories search --query "auth system" --timeline --exclude-topics "wip,draft"

Getting Started

The --exclude-topics filter is available in CLI v1.7.21:

mx update
mx --version  # Should show 1.7.21

Start with simple exclusions and build up your topic vocabulary as you discover what filtering patterns work best for your workflow.

The Filtering Philosophy

Search is about reducing a large space to exactly what you need. --topics lets you specify where to look. --exclude-topics lets you specify where not to look. Together, they give you the precision to find exactly the memories that matter for the task at hand.

Because effective search isn't just about finding things—it's about finding the right things.

The --exclude-topics filter is available now in MemNexus CLI v1.7.21. Update with mx update or install with npm install -g @memnexus-ai/cli.

Precision Search: Include What You Want, Exclude What You Don't