Skip to content
 
 

Latest commit

 

History

38 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sheh

Shell Exposed HTTP

Gotty inspired. Sheh is a command line tool that broadcasts your terminal to your browser on localhost. It works for every Unix/Linux shell and even PowerShell!

NPM Version javascript license

sheh-linux

Running sheh on Linux


win-sheh

Running sheh on Windows


Stack

Shell Exposed HTTP are currently built with

express ws node-pty xterm.js node morgan


Install

Get via the node package manager registry.

npm install -g @matteodelseppia/assetto-sheh

Usage

Launching Shell Exposed HTTP...

sheh

Sheh automatically opens its local URL in your default browser.

By default, Sheh binds only to 127.0.0.1, so it cannot be accessed from your local network.

To intentionally expose it on your local network, use:

sheh --network

The network mode has no authentication or encryption; use it only on networks you trust.

From a browser terminal session, set the browser tab title with:

sheh --title "my-title"

It will output something like this:

output

Visit sheh wiki for more documentations and CLI usage


Features

Sheh is simplified. Including its functionality and setup.

sheh

Traits:

  • Works for every shells.
  • Hosts on localhost by default; local-network access requires --network.
  • Usage through Browser. (Modern such as Firefox, Chrome, Edge)
  • UX keys control for mobile devices.

Shells Support

Sheh starts with your current running shell. So, shells can run interactively depends on processing shell you ran your sheh command from. Below are the verified and tested shells:

Shell Status
sh
bash
zsh
ksh
dash
tcsh
csh
powershell
fish
nushell

Niche shell supports: CGTerm & fcsh. Check them out!


News 📢

1.4.0

Added

  • Command Line Interface and commands
    • shell: display sheh detected shell
    • version: print version number
    • help: show the CLI manual
    • server: manages sheh childs

Warning

1.4.0 is deprecated because of a critical code mistake, please use the later version of sheh (>v1.4.0)

Check more in CHANGELOG


Notes

Note

Sheh is in an early stage of concept and development. Expect bugs, vulnerabilities, and missing features.

Caution

Sheh binds to localhost by default. Passing --network exposes an unauthenticated, unencrypted, unsandboxed terminal on your local network; anyone who can reach it can run commands as you. Use network mode only on a trusted network. In accordance with the GPL-3.0 license, this software is provided "as is" without warranty of any kind. The authors assume no liability for data loss, security breaches, or system damage resulting from its use. Use at your own risk.

Termux is currently not supported. Sheh relies on a native PTY environment, which is unavailable in Termux's sandbox. Support is planned for a future release.


Contribution

Sheh are always welcome for cooperating. Contributors can contribute through by making a fork of this repository or using GitHub Codespaces then do a Pull Request


LICENSE

Sheh (Shell Exposed HTTP) is GPL-3.0 Licensed

About

Fork of https://github.com/waxodium/sheh

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages