Skip to main content

Description

Searches your work journal to find when you last worked on something, touched a file, or used a branch. Supports text search, tag filtering, and file path lookup with optional AI-powered summaries. Aliases: search, find

Usage

Arguments

string[]
Search query (e.g., “auth”, “login page”, “PROJ-123”). Multiple words are joined into a single query.

Options

string
Filter by project identifier
string
Start date for search range (YYYY-MM-DD)
string
End date for search range (YYYY-MM-DD)
string
default:"90"
Search last N days
string[]
Filter by tags
string
Search for a specific file path
string
default:"10"
Max results to show
boolean
Generate an AI-powered summary of the search results
boolean
Do not copy AI summary to clipboard
boolean
Output results as JSON
boolean
Show debug output

Examples

Search by keyword

Search for a phrase

Find ticket work

Search for a file

Search by tag

AI summary of results

Custom date range

Last 180 days, more results

Search specific project

JSON output

Search Behavior

The recall command searches across:
  • Commit messages - Full text search
  • Branch names - Pattern matching
  • File paths - Changed files in commits
  • PR titles - Pull request descriptions
  • Ticket IDs - Linked tickets
  • Notes - Manual notes in snapshots
  • Tags - Custom tags

Match Scoring

Results are scored and ranked by:
  • Exact matches in commit messages
  • File path matches
  • Ticket ID matches
  • Tag matches
  • Recency (more recent = higher score)

File History Mode

When using --file, the output shows:
  • All dates the file was modified
  • Commits that changed the file
  • Commit messages and hashes

AI Summary Mode

With --ai, generates a summary that answers:
  1. Summary - What the work was about
  2. Timeline - When key activities happened
  3. Key details - Branches, PRs, files, tickets
  4. Current state - Is it done, in progress, or abandoned?

JSON Output

With --json, returns structured data:

Requirements

  • Journal snapshots (created with devdaily snapshot)
  • GitHub Copilot CLI (for --ai mode only)