get_command_history
Retrieve recent command execution records from Windows CLI sessions to review past actions, outputs, and timestamps for troubleshooting or auditing purposes.
Instructions
Get the history of executed commands
Example usage:
{
"limit": 5
}Example response:
[
{
"command": "Get-Process",
"output": "...",
"timestamp": "2024-03-20T10:30:00Z",
"exitCode": 0
}
]Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of history entries to return (default: 10, max: 1000) |
Implementation Reference
- src/index.ts:694-725 (handler)Handler function for the 'get_command_history' tool. Checks if command logging is enabled, parses optional limit parameter, retrieves recent history entries from this.commandHistory, truncates output, and returns JSON-formatted history.
case "get_command_history": { if (!this.config.security.logCommands) { return { content: [{ type: "text", text: "Command history is disabled in configuration. Consult the server admin for configuration changes (config.json - logCommands)." }] }; } const args = z.object({ limit: z.number() .min(1) .max(this.config.security.maxHistorySize) .optional() .default(10) }).parse(request.params.arguments); const history = this.commandHistory .slice(-args.limit) .map(entry => ({ ...entry, output: entry.output.slice(0, 1000) // Limit output size })); return { content: [{ type: "text", text: JSON.stringify(history, null, 2) }] }; } - src/index.ts:324-355 (registration)Registration of the 'get_command_history' tool in the list of tools returned by ListToolsRequestSchema, including description and input schema definition.
{ name: "get_command_history", description: `Get the history of executed commands Example usage: \`\`\`json { "limit": 5 } \`\`\` Example response: \`\`\`json [ { "command": "Get-Process", "output": "...", "timestamp": "2024-03-20T10:30:00Z", "exitCode": 0 } ] \`\`\``, inputSchema: { type: "object", properties: { limit: { type: "number", description: `Maximum number of history entries to return (default: 10, max: ${this.config.security.maxHistorySize})` } } } }, - src/types/config.ts:52-58 (schema)Type definition for CommandHistoryEntry used in command history storage and output of get_command_history tool.
export interface CommandHistoryEntry { command: string; output: string; timestamp: string; exitCode: number; connectionId?: string; }