failed_commands
Retrieve recently failed commands (non-zero exit) to quickly identify what broke. Optionally filter by timestamp for targeted troubleshooting.
Instructions
Read-only. Lists recent commands that exited non-zero — a quick "what just broke?" feed. Optionally restrict to commands after a given epoch-millisecond timestamp. Requires the shell hook for exit-code capture (legacy entries have no exit code). Newest first. Local index only.
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": "failed_commands"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of commands to return, newest first. Default 20. | |
| since_ts_ms | No | Only return commands with a timestamp at or after this epoch-millisecond value. Null/omitted = no lower bound. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| results | No |