Todas las herramientas

run_terminal_command

Diagnóstico y sistema · macOS · Windows

Efecto: ejecución. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Ejecuta un comando (`command`) de shell en la Mac del usuario y devuelve su resultado. Siempre activo. Deshabilitado cuando LMCP está en modo de solo lectura. Se rechazan los comandos peligrosos (sudo, eliminaciones recursivas de rutas de inicio/sistema, formateo de disco, apagado/reinicio, canalización de un script descargado a un shell, bombas fork, control de demonios). Destructivo: primero obtiene una vista previa del comando; pase confirm:true para ejecutarlo. La salida y el tiempo de ejecución están limitados.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "command": {
      "description": "The shell command to run (a single command line, executed with /bin/zsh -lc).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually run. Without it, a preview of the command is returned.",
      "type": "boolean"
    },
    "timeout_seconds": {
      "description": "Max seconds to run before it is terminated (default 20, max 60).",
      "type": "integer"
    },
    "working_dir": {
      "description": "Optional absolute working directory. Defaults to the user's home directory.",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para run_terminal_command. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "command": "echo Hello from LMCP",
  "confirm": false
}

Windows

Propósito

Ejecuta un comando (`command`) de shell en la computadora del usuario. Se rechazan los comandos peligrosos (sudo/escalada de privilegios, eliminaciones recursivas de rutas de inicio o del sistema, formateo de disco, apagado/reinicio, canalización de un script descargado a un shell, bombas de bifurcación). Destructivo: primero obtiene una vista previa del comando; pase confirm:true para ejecutarlo. La salida y el tiempo de ejecución están limitados. En Windows, el comando se ejecuta a través de `cmd /c`; en otro lugar a través de `sh -c`.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "command": {
      "description": "The shell command to run (a single command line).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually run. Without it, a preview of the command is returned.",
      "type": "boolean"
    },
    "timeout_seconds": {
      "description": "Max seconds to run before it is terminated (default 30, max 60).",
      "type": "integer"
    },
    "working_dir": {
      "description": "Optional absolute working directory. Defaults to the user's home directory.",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para run_terminal_command. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "command": "echo Hello from LMCP",
  "confirm": false
}