a0-cli-remote-workflows
Guide safe use of A0 CLI remote shell execution and remote file editing on the connected host machine. Load before using code_execution_remote or text_editor_remote for local project work through the CLI connector.
Best for Local development tasksWorks with GitHub
⌘source
- author
@agent0ai- language
- Python
★17kstars
3.5kforks
Apr 29, 2026
✦overview.md
Key Features
- ·Read-only mode for safe inspection
- ·Read&Write mode for modifications
- ·Supports shell execution and file editing
- ·Works only on CLI host machine
- ·Triggered by specific tool names
Use Cases
- →Inspect local project files on CLI host
- →Run commands on the host machine via remote shell
- →Edit local files through A0 CLI connector
Best for
- ✓Local development tasks
- ✓CLI-connected workflows
Not ideal for
- !Server-side or Docker tasks
FAQs
name
a0-cli-remote-workflows
description
Guide safe use of A0 CLI remote shell execution and remote file editing on the connected host machine. Load before using code_execution_remote or text_editor_remote for local project work through the CLI connector.
version:1.0.0
author:Agent Zero Team
tags:["agent-zero","a0","cli","connector","remote-execution","remote-files"]
trigger_patterns:["code_execution_remote","text_editor_remote","remote file editing","remote shell execution","edit my local files through a0 cli","run commands on the cli host"]
allowed_tools:["code_execution_remote","text_editor_remote"]
A0 CLI Remote Workflows
Boundary
Use code_execution_remote and text_editor_remote only for work on the machine where A0 CLI is running. These paths, shells, runtimes, 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 tools instead.
Access Modes
- Read only: inspect files and poll/reset existing execution sessions. Do not attempt writes or mutating shell work until the user switches the CLI to Read&Write with F3.
- Read&Write: shell-backed execution, writes, and patches may modify the CLI host. Keep changes narrow and intentional.
- Execution may also be disabled locally in the CLI. If a remote tool returns a structured disabled/no-client error, explain the required CLI toggle instead of falling back to the server filesystem.
Remote Execution
- Use
runtime=terminalfor shell commands,runtime=pythonfor Python snippets, andruntime=nodejsfor Node.js snippets. - Reuse the same integer
sessionwhile continuing a workflow; session state is local to the CLI frontend.
$install
1-click copynpx skills add agent0ai/agent-zero --skill a0-cli-remote-workflowsSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
2/ 5
fairThe main idea is there, but the wording is messy and easy to misinterpret.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
2/ 5
lowSome hints are present, but an agent still has to guess many steps.