Download the PHP package phattarachai/remote-prompt without Composer

Remote Prompt

A PHPStorm-style remote host panel for the terminal. Type rh inside a project, pick one of its servers, and open a shell already in the deploy path, browse files, download a backup or upload a file. Connections come from your own ~/.ssh/config, so keys, ssh-agent, jump hosts and ProxyCommand tunnels work as they do for plain ssh. Built on Laravel Prompts, but it is a standalone CLI that works in any project, Laravel or not, from one global install.

• Targets per project, committed. A project's targets live in .rh.json at its root, so every checkout, worktree, machine and AI agent knows where it is deployed. A server can serve any number of projects; targets only you need stay in your own config.
• Your ssh config is the source of truth. A target only names an ssh alias. Hosts rh creates go to ~/.ssh/config.d/rh.conf, so plain ssh, scp and git know them too. No passwords are stored anywhere.
• One connection per host. rh opens an ssh control master that later calls reuse for ten minutes, so browsing through a slow tunnel (GCP IAP, a jump host) pays the handshake once.
• Production asks first. Uploads, edits and artisan commands on a production target wait for a yes — and are refused outright without a terminal, so a script or an AI agent can read from production but never write to it.

Installation

Make sure Composer's global vendor/bin is on your PATH, then run rh --help.

Getting started

Coming from PHPStorm? Import its Deployment servers — one project, or every project under a folder:

Each server's path becomes its root path joined with the mapping's deployment path. Its host is matched to an existing ~/.ssh/config alias by host name, so tunnels and keys you already set up keep working; unknown hosts get a new alias in rh.conf. Then check every connection:

Or add a target by hand inside a project with rh add: pick an ssh alias, then walk the server's folders from /var/www — folders named like the project are starred on top. When the app's files belong to another user (www-data), rh offers it as the target's run_as. Inside a repository the target goes to .rh.json — commit it.

A server you have never connected to: pick New host…. rh writes the alias to ~/.ssh/config.d/rh.conf, tries your key, and when the server refuses it offers ssh-copy-id — you type the server's password once, into ssh.

Scripts and agents add targets without questions:

The name and environment default to what the interactive flow would pick; a folder that doesn't exist on the host is refused unless --force.

Commands

A relative path is relative to the target's deploy path: rh get prod:storage/logs/laravel.log. Any ssh alias works ad hoc with an absolute path: rh get backup-box:/backups/db.sql.gz. An alias that isn't one of the project's targets counts as production, so writes to it ask first.

On production, rh artisan runs read-only commands (about, route:list, migrate:status, schedule:list, queue:failed, horizon:status, model:show, db:show, …) as is; anything else asks first, and is refused without a terminal. With run_as set it runs sudo -u <user> env HOME=/tmp php artisan …, so new log and cache files stay writable for the app (without a terminal sudo -n, which fails at once rather than waiting for a password).

Configuration

.rh.json — the project's targets, committed

At the root of the repository, so every checkout, worktree and machine — and any AI agent working in the project — knows where it is deployed:

host is an alias in ~/.ssh/config, which keeps the connection itself (keys, users, proxies) per machine. Use the same alias names on every machine. hosts is optional: it tells rh doctor how to write the block for an alias a machine doesn't have yet (gcp_iap rides Identity-Aware Proxy with gcloud's key). It holds no secrets.

Inside a repository, rh add writes here (--save=machine keeps a target to this machine instead).

~/.config/rh/config.json — this machine's projects

For folders without a .rh.json, and for targets only you need. A project's .rh.json targets come first; this file's targets for the same folder are added after them, unless the names clash:

env is one of production, uat, qas, staging, dev; a target without one is production. Only production asks before writes. run_as (optional) is the user rh artisan switches to.

Background calls (listing, reading, checks) run ssh in batch mode, so a host that only takes a password works for them only while a rh ssh session's shared connection is open — ssh-copy-id <alias> once fixes that for good.

ผู้พัฒนา

พัฒนาและดูแลโดย บริษัท ภัทรชัย อาร์ทิซาน จำกัด (Phattarachai Artisan) บริษัทที่ปรึกษาและพัฒนาเว็บ ที่เรียนรู้และแบ่งปันกับชุมชน Laravel แพ็กเกจนี้แบ่งปันให้ชุมชนนำไปใช้และต่อยอดได้อย่างอิสระ

ดูแพ็กเกจอื่นของเราได้ที่ phattarachai.dev/open-source และติดต่อเราได้ที่ phattarachai.dev