Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/way29/hackbox
An lightweight and easy to use toolbox for hackers
https://github.com/way29/hackbox
Last synced: about 2 months ago
JSON representation
An lightweight and easy to use toolbox for hackers
- Host: GitHub
- URL: https://github.com/way29/hackbox
- Owner: WAY29
- License: mit
- Created: 2022-05-09T12:07:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-11-17T03:46:16.000Z (about 2 years ago)
- Last Synced: 2024-06-19T02:20:56.359Z (6 months ago)
- Language: Go
- Size: 48.8 KB
- Stars: 12
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Features •
Installation •
Usage •
Running •
Notes
hackbox is an lightweight and easy to use toolbox for hackers, it is designed to organize and uniformly call your favorite command line tools.
# Features
- Highly **interactive command line framework** powered by [c-bata/go-prompt](https://github.com/c-bata/go-prompt)
- Easy to use and intelligent **automatic completion**
- **Rich and self-explanatory default configuration files**, so you can easily customize it
- **Built-in several command line tools for hackers** (in comming...)
- Clear arguments settings, no need to read annoying help documents, so you can **call tools faster and more conveniently**
- Save the execution result of the tool which can be **used as input to another tool or easily exported**
- Command line parameters **support validate** powered by [go-playground/validator](https://github.com/go-playground/validator)
# Installation
## go get
hackbox requires go1.17 to install. Run the following command to get hackbox:
```go
go install -v github.com/WAY29/hackbox/cmd/hackbox@latest
```
## static releases
Download hackbox from [Releases](https://github.com/WAY29/hackbox/releases)
# Usage
Just run hackbox, and you will get an interactive hackbox shell. Here are hackbox help documents:
```
Usage of hackbox:
-nc
Print without color
-p string
Custom tool path, default will load from ./tools.toml -> $HOME/.config/hackbox/tools.yaml
-q Run hackbox without banner
```
# Running
You can run some intuitive commands, such as `cd`, `ls`, `sh`, `exit`
- `cd ` change tool directory
- `ls` List tools and subdirectories in this directory
- `sh ` Run local shell command
- `exit` Exit hackbox
When you find the tool you want, `use` it immediately, then you can `show` or `set` or `unset` arguments, then just `run` it.
- `use ` use specified tool
- `set ` set tool argument
- `unset ` unset tool argument
- `show [arg name]` Show tool argument(s)
- `run [as ] [bg]` Run tools [in background]
Then you can `output` the result or `export` it, before this, maybe you want to `filter` it or `merge` other result
- `output [output name]` show output(s)
- `filter [as ]` filter output by filters **link/email/date/time/phone/ip/md5/sha1/sha256**
- `merge as ` merge two outputs as one
- `export [export path, default .txt]` export output as file
By the way, you can `setoutput` or `unsetoutput`
- `setoutput ` set output from input or file
- `unsetoutput ` unset output
# Notes
- It only took me three days to write this project, so there may be some mistakes, welcome issues.
- If you have any commonly used hacking tools that are not included in hackbox, welcome pull-requests(tools.default.yaml) and issues.