recent_conversations
Fetches the most recent turns from your latest conversations. This is the go-to tool for session-start orientation — call it when a user jumps in mid-topic and you need to catch up.
Parameters
| Parameter | Type | Required | Default | Description |
|---|
num_conversations | integer | No | 3 | Number of recent conversations to return |
num_turns | integer | No | 3 | Number of recent message turns per conversation |
Read-only
Yes. This tool only reads from your memory.
Example usage
Uses the defaults: 3 recent conversations, 3 turns each.
{
"num_conversations": 5,
"num_turns": 5
}
When to use
- At the start of every session when the user references an ongoing topic
- When the user says things like “that bug,” “the refactor we discussed,” or “where were we”
- To orient yourself before responding to an ambiguous opening message
This is often the very first tool call in a session. Follow it up with ask_question if you need more detail on a specific topic the user mentions.
Common pattern
1. recent_conversations() → orient yourself
2. ask_question("the caching issue from today") → get specific details
3. Respond to the user with full context
