Todas las herramientas

file_list

Archivos y Finder · macOS · Windows

Efecto: lectura. 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

Enumera archivos y carpetas en un directorio local. El valor predeterminado es el directorio de inicio del usuario. Devuelve el nombre, la ruta (`path`), el tipo (archivo/directorio), el tamaño y la fecha de modificación de cada elemento. Ordenado: primero los directorios, luego los archivos, ambos alfabéticamente.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglésmacOS
{
  "properties": {
    "path": {
      "description": "Absolute path to the directory. Defaults to the home directory (~) if omitted.",
      "type": "string"
    },
    "show_hidden": {
      "description": "Include hidden files (starting with '.'). Default false.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para file_list. 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.

{
  "path": "/Users/demo/Documents"
}

Windows

Propósito

Enumera archivos y carpetas en un directorio local. El valor predeterminado es el directorio de inicio del usuario. Devuelve nombre, ruta (`path`), tipo (archivo/directorio), tamaño y hora de modificación de cada elemento. La ruta debe estar dentro de una carpeta permitida (directorio de inicio por defecto).

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglésWindows
{
  "properties": {
    "path": {
      "description": "Absolute path to the directory. Defaults to the home directory (~) if omitted.",
      "type": "string"
    },
    "show_hidden": {
      "description": "Include hidden files (dotfiles). Default false.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para file_list. 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.

{
  "path": "C:\\Users\\demo\\Documents"
}