mayros search

Search conversation history across all saved sessions. Performs case-insensitive matching on message content and returns results with timestamps, role tags, and context snippets.

Arguments

  • <query> — Search query (case-insensitive)

Options

OptionDescription
--role <role>Filter by message role: user or assistant
--since <date>Only messages after this date (ISO 8601 or YYYY-MM-DD)
--before <date>Only messages before this date
--limit <n>Max results (default: 20)
--session <id>Search a specific session ID only

Output

Each result shows:

  • Timestamp (ISO format, minute precision)
  • Role tag ([You] or [AI])
  • Session ID
  • Snippet of the matching message (up to 120 characters)

The summary line reports total matches, sessions searched, and search duration.

Examples

bash
mayros search "authentication"
mayros search "deploy" --role user --limit 10
mayros search "error" --since 2025-01-01
mayros search "refactor" --before 2025-06-01 --session abc123
mayros search "database migration" --role assistant --limit 5