ssh
An extension to run remote SSH commands and transfer files using the Paramiko library.
Open source Open in the app JSON README (API)
About
An extension to run remote SSH commands and transfer files using the Paramiko library.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- involvex
- Origin
- gemini
- Category
- ferramentas
- Version
- 2.1
- Stars
- 7
- Forks
- 3
- Last push
- 2025-11-14T13:46:02Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
involvex/gemini-cli-ssh-extension
README
# SSH Extension for Gemini CLI (v2.1)
This extension provides a robust `/ssh` command for interacting with remote servers, enabling secure command execution directly from the Gemini CLI.
It uses the `paramiko` Python library, ensuring reliable and secure connections.
## Features
- **Simplified Command:** A single `/ssh` command for all remote execution.
- **Standard SSH Syntax:** Uses familiar `user@hostname "command"` syntax.
- **Secure Connections:** Leverages the `paramiko` library and your local SSH agent for authentication.
- **Detailed Output:** Returns `stdout`, `stderr`, and the `exit_code` for every command.
## Installation
1. **Prerequisites:** Ensure you have Python and `pip` installed.
2. **Install Dependencies:** From within this extension's directory, run:
```bash
pip install -r requirements.txt
```
3. **Install the Extension:** Run the following command from the extension's directory:
```bash
gemini extensions install .
```
4. **Restart Gemini CLI:** **This is a critical step.** Close and reopen the Gemini CLI to ensure the new `/ssh` command is registered.
## Usage
The extension provides a single `ssh` tool that can be used like a command.
### `ssh`
Executes a shell command on a remote host. The arguments should be a single string in the format `user@hostname "command"`.
**Example:**
```
/ssh args='bitnami@63.178.255.78 "df -h"'
```