Host File Editing

Boundary

Use text_editor_remote only for file work on the machine where A0 CLI is running. These paths and files belong to the CLI host, not the Agent Zero server or Docker container.

If the task belongs inside Agent Zero's own runtime, use the normal server-side file tools instead.

Access Modes

• Read&Write: reads, writes, and patches may modify the CLI host. Keep changes narrow and intentional.
• Read only: inspect files only. If writes are blocked, tell the user to switch local file access to Read&Write with F3.

Editing Flow

• Start with read when inspecting a file or preparing line-based edits.
• Use write only when replacing or creating the whole file is truly the right operation.
• Prefer patch with old_text and new_text for simple exact replacements.
• Use patch_text for context-anchored edits, especially after inserts/deletes or when line numbers may have shifted.
• Use patch with edits only for small line-range edits based on the latest remote read.
• If freshness-aware line patching rejects an edit as stale, reread the file and retry with updated ranges.
• Treat reads as bounded text previews (2,000 lines / 256 KiB). Follow next_line for another small slice; use the authenticated HTTP transfer path for complete large files and binary data.
• Keep each write or patch payload within 256 KiB. Do not split a binary file into text-editor calls.

Patch Text Rules