plugin.json

{
  "name": "screen-record",
  "version": "1.0.1",
  "description": "Screen recording via ffmpeg x11grab — start, stop, and list recordings on the agent VM",
  "tools": [
    {
      "name": "start_recording",
      "description": "Start an ffmpeg x11grab screen recording of the active X display (the inherited $DISPLAY, falling back to :0). Returns the output file path.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string",
            "description": "Optional base name for the recording file (without extension). Defaults to a timestamp-based name."
          }
        }
      },
      "handler": "bash handlers/start_recording.sh"
    },
    {
      "name": "stop_recording",
      "description": "Stop the currently running screen recording and return the final file path.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "handler": "bash handlers/stop_recording.sh"
    },
    {
      "name": "list_recordings",
      "description": "List all screen recordings in the recordings directory with file sizes and timestamps.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "handler": "bash handlers/list_recordings.sh"
    }
  ]
}