Specially made for replit users who can't pay for ssh access. Works on any device as long as it runs windows, linux or mac.

1. Installation of NodeJS (>=16)

1. Any command that reads line from terminal or asks for input doesn't work.
2. You can only send a command when the previous one had responded.
3. Any command that crashes node on your server will disconnect the websocket.

This code would start a websocket on your port 3000 which can be connected to like this wss://<hostname>:3000

const { Server } = require('rootless-ssh');

const server = new Server({
    // these are default values
    welcomemsg: '',
    port: 3000,
    path: '/ssh',
    auth: 'changeme' // unique token that needs to be in the `authorization` header when connecting to websocket as `Bearer <password>`
});

server.start();

Note: Make sure to change the auth property as this can give an attacker access to your terminal. Even without root access, an attacker can do much damage to your system.

This code would connect to the websocket and you would be able to enter commands on your console.

const { Client } = require('rootless-ssh');

const client = new Client(url /* wss://<hostname>:<port> */,auth /* auth password */);

client.connect();

Due to the technical limitations, we had to introduce some custom cli commands for certain works.

dirchange: Works as a cd or chdir command. Same syntax.

More commands will be introduced as we recieve requests.

While this package is being actively tested, please know that bugs may appear. If you come across a bug, report in the issues tab on our github.