@oresk/pi-remote-tools

Remote SSH tools for pi coding agent. Provides ssh-read, ssh-write, ssh-edit, and ssh-bash with per-call host targeting.

Packages

Package details

extension

Install @oresk/pi-remote-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@oresk/pi-remote-tools
Package
@oresk/pi-remote-tools
Version
0.1.1
Published
Jun 25, 2026
Downloads
94/mo · 14/wk
Author
oresk
License
MIT
Types
extension
Size
17.8 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-remote-tools

SSH remote file and command tools for pi coding agent. Provides ssh-read, ssh-write, ssh-edit, and ssh-bash — each takes a host parameter, so no toggle state is needed between local and remote work.

Installation

pi extension add @oresk/pi-remote-tools

Or install globally:

npm install -g @oresk/pi-remote-tools

Tools

ssh-read

Read a file on a remote host via SSH.

{
  "host": "myserver",
  "path": "/etc/os-release",
  "limit": 10
}

ssh-write

Create or overwrite a file on a remote host.

{
  "host": "myserver",
  "path": "/tmp/test.txt",
  "content": "hello world"
}

ssh-edit

Make precise file edits on a remote host using exact-text replacement.

{
  "host": "myserver",
  "path": "/etc/nginx/nginx.conf",
  "edits": [
    {
      "oldText": "worker_processes 1;",
      "newText": "worker_processes auto;"
    }
  ]
}

ssh-bash

Execute a bash command on a remote host.

{
  "host": "myserver",
  "command": "uptime",
  "timeout": 30
}

Requirements

  • SSH keys configured and loaded in your SSH agent (run ssh-add -l to verify)
  • Host aliases defined in ~/.ssh/config, or use user@host format directly

License

MIT