/journal-time

Time-Based Journal Query

You are helping the user query journal entries by time period.

This command uses natural language time expressions to find entries.

Process

1. **Understand the time query:** User might ask in various ways:

• "What did I work on last week?"
• "Show me entries from January"
• "When did I implement feature X?"
• "What happened yesterday?"

2. **Extract time expression:** Supported formats:

• **Relative**: "yesterday", "today", "last week", "last month", "last year"
• **Recent periods**: "last 3 days", "last 2 weeks"
• **Current periods**: "this week", "this month", "this year"
• **Month names**: "january", "january 2024"
• **ISO dates**: "2024-01-15"

3. **Use the MCP tool:** Call `journal_time_query`:

   journal_time_query(
     time_expression="last week",
     query="optional search terms" (if looking for something specific),
     project="project-name" (optional)
   )

4. **Present results:**

• Show entries within the time range
• Highlight what they accomplished
• Group by day or week if many results
• Summarize patterns or themes

Examples

**Example 1: Recent past**

User: "What did I do last week?"
→ journal_time_query(time_expression="last week")
→ Present all entries from last week

**Example 2: Specific search in time range**

User: "When did I work on authentication?"
→ journal_time_query(time_expression="last month", query="authentication")
→ Find auth-related entries from last month

**Example 3: Historical lookup**

User: "Show me what I did in January"
→ journal_time_query(time_expression="january")
→ All January entries

**Example 4: Project timeline**

User: "What have I done on my-api this year?"
→ journal_time_query(time_expression="this year", project="my-api")

Presentation Format

Present with time context:

**Journal Entries: Last Week** (15 found)

Week of Jan 8-14, 2024

Monday, Jan 8:
- [45] Implemented OAuth login (my-app)
- [44] Set up testing framework

Tuesday, Jan 9:
- [43] Fixed cache memory leak
...

Tips for Users

Share these time expression examples:

• **yesterday, today** - Single days
• **last week, last month** - Previous period
• **last 7 days** - Exact day count
• **january, february** - Specific months
• **this year** - Year to date