astatin3/unshell
1
0
Fork 0
mirror of https://github.com/Astatin3/unshell.git synced 2026-06-08 22:38:01 -06:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Michael Mikovsky
2026-04-24 22:48:08 -06:00
parent 655026dee6
commit cc83acd0d1
1 changed files with 21 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+21 -24
View File
@@ -1,34 +1,31 @@
![unshell logo](https://github.com/astatin3/unshell/blob/main/media/full_banner.png?raw=true) ![unshell logo](https://github.com/astatin3/unshell/blob/main/media/full_banner.png?raw=true)
UnShell is a tree-addressed RPC and data-exchange protocol designed for a hierarchy of endpoints. It provides a lightweight way to route calls, streams, and faults through a tree-structured network of nodes. UnShell is an exploitation orchestration framework.
## Features <details>
<summary>UnShell Orca</summary>
The control plane. A specialized endpoint that provides an orchestration interface to manage and interact with the tree, allowing sophisticated control of implants across a network.
- **Tree-Based Routing**: Path-based addressing with longest-prefix matching. - **status:** Not started.
- **RPC and Streaming**: Supports simple request-response (Call) and bidirectional streaming (Data). </details>
- **Hierarchical Control**: Authority-restricted downward calls and upstream-only faults.
- **Introspection**: Mandatory discovery mechanism for endpoints and leaves.
- **no_std Compatible**: Core protocol implementation is designed for constrained environments.
## Architecture <details>
<summary>UnShell Protocol</summary>
The communication bedrock. A hierarchical, lightweight, and flexible protocol for the control of implants across a network.
The protocol is organized into: - **status:** Protocol and implementation drafted. See [PROTOCOL.md](https://github.com/astatin3/unshell/blob/main/PROTOCOL.md)
- `unshell`: Core protocol logic, framing, and routing. </details>
- `ush-treetest`: A testbed implementation for validating the protocol.
- `ush-obfuscate`: Utilities for code obfuscation.
- `base62`: Encoding utilities.
## Getting Started <details>
<summary>UnShell Build</summary>
A tool built on the rust compiler that compiles projects to very small binaries with obfuscation techniques. The `msfvenom` of this project.
### Build - **status:** Not started.
```bash </details>
cargo build
```
### Run Tests <details>
```bash <summary>libunshell</summary>
cargo test A rust library which provides easy creation of implants through pre-made libraries and endpoints connected to the UnShell protocol.
```
## Protocol Specification - **status:** Not started.
For detailed information on the wire format and behavioral invariants, please refer to `PROTOCOL.md`. </details>