basicmachines-co-basic-memory/claude-code-plugin/commands/organize.md

---

description: Organize and maintain your Basic Memory knowledge graph argument-hint: [health|orphans|duplicates|relations|tags] [project] allowed-tools: mcp__basic-memory__search_notes, mcp__basic-memory__read_note, mcp__basic-memory__list_directory, mcp__basic-memory__edit_note, mcp__basic-memory__write_note

Organize

Help organize, link, and maintain your Basic Memory knowledge graph.

Arguments

• $1 - Action (optional): health, orphans, duplicates, relations, tags (default: health)
• $2 - Project (optional): defaults to "main"

Actions

/organize or /organize health

Run a quick health check:

1. Count total notes
2. Identify orphan notes (no relations)
3. Check for potential duplicates
4. Show folder distribution
5. Report any issues found

/organize orphans

Find and address orphan notes:

1. Search for notes with empty Relations sections
2. List orphans found
3. For each orphan, suggest potential relations based on content
4. Offer to add relations or create index notes

/organize duplicates

Find potentially duplicate notes:

1. Search for notes with similar titles
2. Compare content for overlap
3. Suggest: merge, differentiate, or link with supersedes

/organize relations [note-title]

Suggest relations for a specific note (or recent notes if not specified):

1. Read the target note
2. Search for related content
3. Suggest relation types:
   • relates-to - General connection
   • extends - Builds upon
   • implements - Realizes concept
   • depends-on - Requires understanding of
4. Offer to add selected relations

/organize tags

Review tag consistency:

1. Gather all tags across notes
2. Find similar/duplicate tags (e.g., arch vs architecture)
3. Identify over-used or under-used tags
4. Suggest normalization

Your Task

Execute: /organize $ARGUMENTS

Based on the action requested:

1. Gather data using search and list tools
2. Analyze for the specific issue (orphans, duplicates, etc.)
3. Present findings clearly with counts and examples
4. Offer solutions - ask before making changes
5. Apply fixes using edit_note or write_note when user approves

Always confirm before modifying notes. Show what will change and get approval.

Examples

/organize                    # Quick health check
/organize health             # Same as above
/organize orphans            # Find unlinked notes
/organize duplicates         # Find similar notes
/organize relations          # Suggest links for recent notes
/organize relations "My Note" # Suggest links for specific note
/organize tags               # Review tag consistency
/organize health specs       # Health check on specs project