Recent Claude Work

Purpose: Show recent Claude Code sessions and what you've been working on using the MCP server

---

Using the MCP Tool

The vibe-check MCP server provides a vibe_recent tool that shows recent sessions with full context.

Tool: mcp__vibe-check__vibe_recent

Parameters:

• period (optional): Time period - "today", "yesterday", "week", or "month" (default: "today")
• limit (optional): Maximum sessions to show (default: 10)

---

Usage Flow

When user asks about recent work:

1. Determine time period from user's question:

   • "today" → period="today"
   • "yesterday" → period="yesterday"
   • "this week" → period="week"
   • "this month" → period="month"

2. Call the MCP tool with appropriate period

3. Present results - the tool returns formatted output with:

   • Session ID (shortened)
   • Repository and branch
   • Duration in minutes
   • Activity counts (user/assistant messages)
   • Start time
   • First message preview

4. Offer follow-up actions:

   • View full session details (use vibe_session)
   • Open session in browser (use vibe_view)
   • Search for specific topics (use vibe_search)

---

Example Interactions

Example 1: Today's Work

User: "what did I do today?"

Claude: [Calls mcp__vibe-check__vibe_recent with period="today"]

[Tool returns list of today's sessions with context]

Would you like to:
- View details of a specific session
- Open a session in your browser
- See your overall stats

Example 2: Yesterday

User: "what did I work on yesterday?"

Claude: [Calls mcp__vibe-check__vibe_recent with period="yesterday"]

[Tool returns yesterday's sessions]

Example 3: This Week

User: "what have I been working on this week?"

Claude: [Calls mcp__vibe-check__vibe_recent with period="week"]

[Tool returns all sessions from the past 7 days]

Example 4: More Sessions

User: "show me my last 20 sessions"

Claude: [Calls mcp__vibe-check__vibe_recent with period="month", limit=20]

[Tool returns up to 20 sessions from the past month]

---

Related Tools

Use these complementary MCP tools:

• mcp__vibe-check__vibe_session: Get detailed info about a specific session
• mcp__vibe-check__vibe_search: Search for conversations about specific topics
• mcp__vibe-check__vibe_stats: See overall usage statistics
• mcp__vibe-check__vibe_view: Open a session in the local web viewer
• mcp__vibe-check__vibe_share: Create a shareable link for a session

---

Error Handling

The MCP tool handles errors automatically:

• If no sessions found, it explains that the monitor may not have been running
• If database not accessible, it provides helpful file path information
• All database locking is handled internally with read-only mode

---

Tips

• Use "today" for current day's work
• Use "week" to see broader activity patterns
• The first user message gives good context about what each session was about
• Follow up with vibe_view to open interesting sessions in browser
• Use vibe_search if you remember a specific keyword but not when you worked on it
• Use vibe_session with a specific session ID to get detailed information

---

Advanced: Custom SQL Queries

For custom time-based analysis not covered by vibe_recent, use the mcp__vibe-check__vibe_sql tool:

mcp__vibe-check__vibe_sql(
    query="SELECT event_session_id, COUNT(*) FROM conversation_events WHERE DATE(event_timestamp) = DATE('now') GROUP BY event_session_id",
    limit=100
)

This provides read-only access to the full database with custom SQL. See the vibe-check-sql skill for more examples.

For schema information, see ~/.vibe-check/SCHEMA.md (auto-generated) or use the Read tool.