Todas as ferramentas

run_terminal_command

Diagnóstico e sistema · macOS · Windows

Efeito: execução. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Executa um comando shell no Mac do usuário e retorna sua saída. Sempre ativo. Desativado quando LMCP está no modo somente leitura. Comandos perigosos (sudo, exclusões recursivas de caminhos do sistema/home, formatação de disco, desligamento/reinicialização, canalização de um script baixado para um shell, fork bombs, controle de daemon) são recusados. Destrutivo: visualiza o comando primeiro - passe confirm:true para realmente executá-lo. A saída e o tempo de execução são limitados.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para run_terminal_command. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Executa um comando shell no computador do usuário. Comandos perigosos (escalonamento de sudo/privilégios, exclusões recursivas de caminhos do sistema ou home, formatação de disco, desligamento/reinicialização, canalização de um script baixado em um shell, fork bombs) são recusados. Destrutivo: visualiza o comando primeiro - passe confirm:true para realmente executá-lo. A saída e o tempo de execução são limitados. No Windows o comando é executado via `cmd /c`; em outro lugar via `sh -c`.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para run_terminal_command. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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