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

devdaily recall [query...] [options]
# Or use aliases
devdaily search [query...] [options]

​
Arguments

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

​
Options

​
-p, --project <id>
string
Filter by project identifier
​
--from <date>
string
Start date for search range (YYYY-MM-DD)
​
--to <date>
string
End date for search range (YYYY-MM-DD)
​
-d, --days <number>
string
default:"90"
Search last N days
​
-t, --tag <tags...>
string[]
Filter by tags
​
-f, --file <path>
string
Search for a specific file path
​
-l, --limit <number>
string
default:"10"
Max results to show
​
--ai
boolean
Generate an AI-powered summary of the search results
​
--no-copy
boolean
Do not copy AI summary to clipboard
​
--json
boolean
Output results as JSON
​
--debug
boolean
Show debug output

​
Examples

​
Search by keyword

devdaily recall auth

​
Search for a phrase

devdaily recall "authentication feature"

​
Find ticket work

devdaily recall PROJ-123

​
Search for a file

devdaily recall --file src/auth/login.ts

​
Search by tag

devdaily recall --tag bugfix

​
AI summary of results

devdaily recall login --ai

​
Custom date range

devdaily recall oauth --from 2024-01-01 --to 2024-01-31

​
Last 180 days, more results

devdaily recall api --days 180 --limit 20

​
Search specific project

devdaily recall redis --project backend-api

​
JSON output

devdaily recall webhook --json > results.json

​
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: 
[
  {
    "date": "2024-01-15",
    "projectId": "my-api",
    "branch": "feature/auth",
    "score": 8,
    "matchReasons": ["commit message", "file path"],
    "commits": 3,
    "prs": 1,
    "tags": ["feature", "auth"],
    "notes": "Added OAuth support"
  }
]

​
Requirements

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