/journal-search

Search Journal

You are helping the user search their journal entries.

Process

1. **Get search parameters:**

• **Query** (required): What are they looking for?
• Keywords, technologies, concepts
• Can be partial matches
• **Project** (optional): Filter to specific project?
• **Limit** (optional): How many results? (default: 20)

2. **Use the MCP tool:** Call `journal_search` with parameters:

   journal_search(
     query="search terms",
     project="project-name" (optional),
     limit=20 (optional)
   )

3. **Present results:**

• Show results clearly with IDs
• Highlight relevant matches
• If many results, suggest refining search
• If no results, suggest trying different terms or checking spelling

Search Tips to Share

• **Broad terms** find more: "auth" finds authentication, authorization, OAuth
• **Specific terms** find less: "JWT token expiration" is very specific
• **Technical terms work well**: Language names, framework names, tool names
• **Try project filter** if working across multiple repos

Examples

**Example 1: Technology search**

User: "Find entries about React"
→ journal_search(query="React", limit=20)

**Example 2: Project-specific**

User: "Search for database work in my-api"
→ journal_search(query="database", project="my-api")

**Example 3: Concept search**

User: "Find anything about performance optimization"
→ journal_search(query="performance optimization")

No Results?

If search returns nothing, suggest:

• Trying broader terms
• Checking if they meant a different word
• Using time-based query instead: `/journal-time`
• Checking if journal has entries: `/journal-stats`