rooti/agent-zero-plugin-remote-ops
Watch
1
0
Fork
You've already forked agent-zero-plugin-remote-ops
 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions
This plugin adds a focused remote execution tool for Agent Zero agents that need to inspect or maintain Linux hosts over SSH without building fragile SSH command strings by hand.
7 commits 1 branch 1 tag 126 KiB
  • Python 72.6%
  • Shell 17.9%
  • HTML 9.5%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Lyra ce6c3e5394 docs: restructure README per git-style-rules 
Replace tool-API documentation with project
overview following the required section order:
Title, Description, Quick Start, Key Directories,
Key Files, Tech Stack, Notes.

Detail content remains in the tool prompt.
2026-08-27 14:25:18 +02:00
prompts Initial commit for remote ops plugin 2026-04-25 23:08:26 +02:00
tests feat: complete plugin scaffold per conventions 2026-08-26 21:35:32 +02:00
tools Initial commit for remote ops plugin 2026-04-25 23:08:26 +02:00
webui feat: complete plugin scaffold per conventions 2026-08-26 21:35:32 +02:00
.gitignore feat: complete plugin scaffold per conventions 2026-08-26 21:35:32 +02:00
__init__.py feat: complete plugin scaffold per conventions 2026-08-26 21:35:32 +02:00
AGENTS.md docs: add AGENTS.md for agent guidance 2026-08-27 13:39:43 +02:00
CHANGELOG.md Add changelog for release tracking 2026-04-25 23:47:40 +02:00
default_config.yaml Initial commit for remote ops plugin 2026-04-25 23:08:26 +02:00
deploy.sh feat: complete plugin scaffold per conventions 2026-08-26 21:35:32 +02:00
LICENSE Initial commit for remote ops plugin 2026-04-25 23:08:26 +02:00
plugin.yaml feat: complete plugin scaffold per conventions 2026-08-26 21:35:32 +02:00
README.md docs: restructure README per git-style-rules 2026-08-27 14:25:18 +02:00
thumbnail.jpg Add plugin thumbnail assets 2026-04-25 23:18:37 +02:00

README.md

Remote Ops Plugin for Agent Zero

Agent Zero plugin for remote SSH execution. Provides a single ssh_execute tool for agents that need to inspect or maintain Linux hosts over SSH.

Quick Start

./deploy.sh deploy

No external Python dependencies. Requires the system ssh binary.

Key Directories

Directory Purpose
tools/ Agent Zero native tool (ssh_execute)
prompts/ Tool prompt documentation for agent system
webui/ Plugin config UI and thumbnail
tests/ Test stubs

Key Files

  • plugin.yaml - Plugin manifest (name, version, settings sections)
  • tools/ssh_execute.py - SSH execution tool implementation
  • prompts/agent.system.tool.ssh_execute.md - Tool prompt documentation
  • deploy.sh - Build, deploy, validate, and clean script
  • default_config.yaml - Default runtime configuration

Tech Stack

Python 3.12+ | SSH | asyncio

Notes

  • Mutating remote actions require explicit user approval before execution.
  • Default known_hosts_mode is accept-new; use strict for pinned host keys.
  • run_as_user uses sudo -n internally when it differs from the SSH login user.
  • The tool sends commands via stdin (/bin/sh -s) to avoid quoting issues.
  • Phase 1 scope: single tool only. No persistent sessions, sync helpers, or custom WebUI components.
  • See AGENTS.md for AI coding agent guidance.