List documents
ragdown_listLists documents with path, title, tags, author, and last change, optionally filtered by subfolder, tag, writer, or session. Browse a local Markdown collection by metadata instead of searching it.
Instructions
Browse the documents rather than search them. Returns one line per document: its path, title, tags and last change, who wrote it and in which session when an agent did, and its description when its frontmatter has one. Optionally under a subfolder, with a tag, by who wrote it, or from one session. sort: 'recent' puts the most recently changed first.
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": "ragdown_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only documents with this tag; 'project' also matches 'project/alpha' | |
| sort | No | path | |
| limit | No | ||
| session_id | No | Only documents written in this conversation, as ragdown_remember recorded it | |
| written_by | No | Only documents an agent wrote ('agent': frontmatter has created_by) or only the user's own ('user') | |
| path_prefix | No | Only documents under this subfolder, relative to the documents root, e.g. 'projects/' |