https://github.com/rishan22/revolver
Revolver is a terminal tool. Run scripts with gamified commands, bullet in script and shell casing .
https://github.com/rishan22/revolver
shell shell-script terminal
Last synced: 2 months ago
JSON representation
Revolver is a terminal tool. Run scripts with gamified commands, bullet in script and shell casing .
- Host: GitHub
- URL: https://github.com/rishan22/revolver
- Owner: Rishan22
- License: unlicense
- Created: 2025-10-02T16:31:45.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-02T16:55:17.000Z (9 months ago)
- Last Synced: 2025-10-10T12:21:23.622Z (9 months ago)
- Topics: shell, shell-script, terminal
- Language: Shell
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# REVOLVER
```
╔════════════════════════════╗
║ R E V O L V E R
║ shell script tool
╚════════════════════════════╝
▄▄ ▄▄▄▄ ▄▄▄▄▄▄▄▄
████▄▄▄▄████
▀▀ ▀▀
```
**Revolver** turns your shell into a six-shooter.
Scripts are bullets. The barrel is your HUD.
Pull the trigger, hear a *[BANG]*, or just a lonely *[CLIK]*.
---
## ⚡ Why?
- Stop typing `chmod +x && ./script.sh`.
- Load scripts like ammo, cycle chambers, and fire.
- Errors are *[DUD]*. Missing files are *[CLIK]*.
- Supports macros (“catchphrases”) for quick-draw routines.
---
## 🔧 Install
```bash
git clone https://github.com//revolver
cd revolver
./install.sh
````
Now type `revolver help` to see the commands.
---
## Commands
```
load put a script into the barrel
barrel show HUD
fire pull trigger on current chamber
shoot run ./file in cwd (or [CLIK] if missing)
burst fire through all chambers in sequence
spin randomise pointer (roulette)
chamber rotate cylinder to chamber n
reload eject all bullets
click create click.sh (empty trigger)
set-phrase
save macro catchphrase
trigger
execute saved macro
```
---
## HUD
```
╔═ REVOLVER ═══════════════════════╗
[ ● ● ○ ○ ○ ○ ] slot:2/6
^ pointer
╚═════════════════════════════════╝
```
- **●** = loaded script
- **○** = empty chamber
- **^** = current pointer
---
## Recoil
- `[BANG]` — script executed cleanly
- `[DUD]` — script errored (non-zero exit)
- `[CLIK]` — empty trigger
---
## Playbook
- **Quick-draw**
```bash
revolver shoot test.sh
```
- **Russian roulette**
```bash
revolver spin
revolver fire
```
- **Fan the hammer**
```bash
revolver burst
```
- **Catchphrases**
```bash
revolver set-phrase duel "load build.sh; load test.sh; burst"
revolver trigger duel
```
---
## Licence
This project is released under **The Unlicense**.
```
This is free and unencumbered software released into the public domain.
Do whatever you want, recklessly.
...