list_sessions
Search local AI coding-agent sessions by provider, workspace path, or free-text query and return newest matches, so you can locate prior work before reading or converting a transcript.
Instructions
List local AI coding-agent sessions (Codex, Claude Code, Gemini CLI, Antigravity, OpenCode, MiMoCode, jcode, Pi) newest first. Filter by provider, workspace path substring, or free-text query over workspace and first/last user message. Use this to find past work on a topic before pulling a session in with get_transcript or convert_session.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_sessions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | maximum sessions to return, newest first (default 25, max 100) | |
| query | No | case-insensitive free text matched against the workspace path and the first/last user message | |
| provider | No | only return sessions of this agent; one of the provider ids reported in results (codex, claude, gemini, antigravity, opencode, mimocode, jcode, pi) | |
| workspace | No | case-insensitive substring the session's workspace path must contain |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | sessions that matched the filters before the limit was applied | |
| sessions | Yes |