README.md

SublimeREPL-ssh

Forked from SublimeREPL. (Original Readme)

The purpose of this fork is to enable ssh repl

Limitations

This is not a terminal emulator, it just pushes the text you type through a subprocess running ssh then reads the response back.

• Any interactive terminal actions will not work. eg:
  • password entry
  • ctrl+r reverse search
  • vim for interactive file editing

if using windows and paramkio dependancies work as expected

• paramiko_intercept_vi will intercept you typing vi ./folder/file_to_edit.txt and download the file, to be edited locally, then upload on save.

• For subprocess & ssh repls, ansi codes are stripped from the output and ignored. emulate_ansi_csi will enable interpretting ansi control sequences like carriage return, line clear and cursor moving (limited support!)

• filter_ascii_color_codes set to false will enable displaying terminal color codes (limited support!)

• press shift+tab or shift+space to autocomplete

Getting started

• This method assumes you have ssh private keys .pem to connect to the server as password entry will not work!
• Before connecting to a server for the first time
  • you must ssh into the server using a regular terminal and type yes when the authenticity of host can't be established message appears to add the server to your known_hosts OR
  • open C:\Users\<user>\.ssh\config (create the file if it doesn't exist) and add the line StrictHostKeyChecking no

Keybindings to add

{
   "keys": [<user-defined keys>], "command": "repl_open", "args": {
        "cmd": ["ssh", "-tt", "-i", <path_to_key.pem>, "<user>@<ip-address>"],
        "cmd_postfix": "\n",
        "encoding": {"linux": "utf-8", "osx": "utf-8", "windows": "$win_cmd_encoding"},
        "env": {}, 
        "external_id": "shell",
        "suppress_echo": true,
        "syntax": "Packages/SublimeREPL-ssh/config/Io/Io.tmLanguage",
        "type": "ssh_paramiko"
    },
}