Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nodauf/Girsh

Automatically spawn a reverse shell fully interactive for Linux or Windows victim
https://github.com/nodauf/Girsh

conpty go golang pentest redteam reverse-shell

Last synced: about 2 months ago
JSON representation

Automatically spawn a reverse shell fully interactive for Linux or Windows victim

Awesome Lists containing this project

README

        

[![Go Report Card](https://goreportcard.com/badge/github.com/nodauf/Girsh)](https://goreportcard.com/report/github.com/nodauf/Girsh)
# Girsh (Golang Interactive Reverse SHell)

Who didn't get bored of manually typing the few lines to upgrade a reverse shell to a full interactive reverse shell (tty spawn, stty size ..., stty raw -echo) or typing the command to use [ConPTY](https://github.com/antonioCoco/ConPtyShell).

## Description

With Girsh, just run it and it will detect the OS and execute the correct commands to upgrade it to a full interactive reverse shell.

For a Linux:
- Get the terminal's size
- Spawn a tty using python2.7, python3 and python
- Change the terminal as raw

For a Windows:
- Bypass AMSI and use [ConPTY](https://github.com/antonioCoco/ConPtyShell) to spawn an interactive terminal
- Listen for getting the ConPTY reverse shell

## Custom command
```
sessions: Manage route to socks servers
connect: Manage route to socks servers
menu: Start the reverse shell menu
options: Manage current options (default print them)
start: Start the listener
stop: Stop the listener
restart: Restart the listener
help: help command
```

## Usage

Two modes are available:

### Simple listener
```
go run main.go listener -h
Usage:
girsh listen [flags]

Flags:
-h, --help help for listen

Global Flags:
-d, --debug Debug output
-p, --port int port to listen (default is 1234) (default 1234)
```

### Interactive
```
go run main.go -h
Generate a reverseshell oneliners (credits shellerator).
And listen then run stty raw -echo and send the python command to spawn a tty shell if it's Linux
or use ConPTY if it's windows

Usage:
girsh [flags]
girsh [command]

Available Commands:
help Help about any command
listen Listen and spawn a fully interactive for windows and linux client

Flags:
-d, --debug Debug output
-h, --help help for revshell
-p, --port int port to listen (default is 1234) (default 1234)
```

## Demo

### Linux
![Gif for linux victim](./images/girsh-linux.gif)
### Windows
![PNG for windows victim](./images/girsh-windows.png)