agent0ai/host-file-editing
plugins/_a0_connector/skills/host-file-editing/SKILL.md
Guide safe use of text_editor_remote for reading, writing, and patching files on the connected A0 CLI host. Use when the user asks to inspect or edit files on their computer, local files, CLI host files, or files that are explicitly not Docker/server files.
$ install --global
skillsauthnpx skillsauth add agent0ai/agent-zero host-file-editingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 3:44 AM114.0s1 file scanned
SKILL.md
- name:
- host-file-editing
- description:
- Guide safe use of text_editor_remote for reading, writing, and patching files on the connected A0 CLI host. Use when the user asks to inspect or edit files on their computer, local files, CLI host files, or files that are explicitly not Docker/server files.
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
readwhen inspecting a file or preparing line-based edits. - Use
writeonly when replacing or creating the whole file is truly the right operation. - Prefer
patchwithold_textandnew_textfor simple exact replacements. - Use
patch_textfor context-anchored edits, especially after inserts/deletes or when line numbers may have shifted. - Use
patchwitheditsonly 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.
Patch Text Rules
- Exact replace requires
old_textto match one exact current span; use a longer span if it matches multiple places. patch_textsupports update hunks for one file.- Use one
@@ existing lineanchor, then+new lineentries for insertion. - For replacement, use
@@ before targetfollowed by-oldand+new, or use@@ old targetfollowed by the same replacement pair. - Do not repeat the same old line as both context and deletion in one hunk.
- Every non-header content line must begin with exactly one prefix: space for context,
+for additions, or-for removals. - Do not stack multiple
@@anchors for one insert.
Failure Handling
- If no CLI is connected, ask the user to connect A0 CLI to this Agent Zero instance.
- If writes are blocked, tell the user to switch local file access to Read&Write with F3.
- If a request times out or the CLI disconnects, summarize the failure and wait for reconnection.
Related Skills
agent0ai/writer-documents
testing
VerifiedTrustedCommunity
Use when creating, opening, or editing LibreOffice Writer ODT documents, or DOCX documents only when Microsoft Word compatibility is explicitly required.
17,774SKILL.mdUpdated May 16, 2026
agent0ai/impress-presentations
testing
VerifiedTrustedCommunity
Use when creating, opening, or editing LibreOffice Impress ODP presentations, or PPTX decks only when PowerPoint compatibility is explicitly required.
17,774SKILL.mdUpdated May 16, 2026
agent0ai/calc-spreadsheets
testing
VerifiedTrustedCommunity
Use when creating, opening, or editing LibreOffice Calc ODS spreadsheets, or XLSX workbooks only when Excel compatibility is explicitly required.
17,774SKILL.mdUpdated May 16, 2026
agent0ai/linux-desktop
data-ai
VerifiedTrustedCommunity
Use when the user asks Agent Zero to operate the built-in Linux Desktop, XFCE apps, LibreOffice GUI apps, file manager, terminal, or visual desktop workflows.
17,774SKILL.mdUpdated May 16, 2026