kitty_ls
Retrieve the full hierarchy of kitty OS windows, tabs, and windows as a JSON tree. Filter by window or tab match to get specific IDs, titles, PIDs, and layouts.
Instructions
List all kitty OS windows, tabs, and windows as a JSON tree. Returns the full hierarchy: OS-window[] -> tab[] -> window[], including window IDs, titles, PIDs, cwds, foreground processes, and layout info. Use --match / --match-tab to filter. Results are cached for 3 seconds.
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": "kitty_ls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| self | No | If true, only return information about the window this command runs in. | |
| match | No | Window match expression to filter windows (e.g. "title:my_term", "id:42"). Uses kitty match syntax. | |
| match_tab | No | Tab match expression to filter tabs (e.g. "index:0", "title:work"). | |
| all_env_vars | No | If true, include all environment variables for each window, not just those that differ from the kitty process. |