Todas las herramientas

file_write

Archivos y Finder · macOS · Windows

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

Escribe texto en un archivo local: crear, sobrescribir o agregar. Admite archivos txt/md/csv/json/log y cualquier archivo de código o texto sin formato. Para documentos de Word, usa word_create; para Excel, excel_create; y para PowerPoint, ppt_create. Escribe en cualquier lugar de esta Mac, con dos excepciones: archivos que su máquina ejecuta por sí sola (archivos de inicio de shell, LaunchAgents, git hooks, configuraciones de cliente AI) y las ubicaciones de credenciales nunca se escriben. Sobrescribir un archivo existente requiere confirm=true (en su lugar, la primera llamada devuelve una vista previa); append=true se agrega al final y nunca necesita confirmación. Se crean las carpetas principales que faltan.

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": {
    "append": {
      "description": "Append to the end instead of overwriting (default false)",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Ejemplo documental

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

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "/Users/demo/Documents/meeting-notes.txt"
}

Windows

Propósito

Escribe texto en un archivo local: crear, sobrescribir o agregar. La ruta (`path`) debe estar dentro de una carpeta permitida (directorio de inicio de forma predeterminada; extender mediante la clave de configuración fs_allowed_roots). Se crean las carpetas principales que faltan. Sobrescribir un archivo existente requiere confirm=true (en su lugar, la primera llamada devuelve una vista previa); Crear un nuevo archivo y append=true nunca necesita confirmación.

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": {
    "append": {
      "description": "Append to the end instead of overwriting (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write.",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Ejemplo documental

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

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}