dingbatter/shebangcli repository overview

⁠shebangcli

Command-line tool for shebang.run⁠ - manage and execute scripts from your terminal.

⁠Quick Start

bash

⁠Login and generate API credentials

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli login

⁠List your scripts

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli list

⁠Get a script

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli get myscript

⁠Run a script

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli run myscript

⁠Create Alias

bash alias shebang='docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli'

⁠Now use it like a native command

shebang list shebang get deploy shebang run -a myscript

⁠Features

• Script Management - List, search, upload, and download scripts
• Automatic Decryption - Decrypt encrypted scripts with your private key
• Key Management - Generate, list, and delete RSA keypairs
• Script Execution - Run scripts with confirmation prompts
• API Token Auth - Secure authentication with Client ID/Secret
• Community Browse - Discover public scripts from other users

⁠Commands

⁠Examples

⁠Basic Usage

bash

⁠Login

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli login

⁠List scripts

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli list

⁠Search community

docker run -it --rm -v ~/.shebangrc:/root/.shebangrc dingbatter/shebangcli search -c "deploy"

⁠With Private Keys

bash

⁠Get encrypted script

docker run -it --rm
-v ~/.shebangrc:/root/.shebangrc
-v ~/keys:/keys
dingbatter/shebangcli get -k /keys/private.pem encrypted-script

⁠Run encrypted script

docker run -it --rm
-v ~/.shebangrc:/root/.shebangrc
-v ~/keys:/keys
dingbatter/shebangcli run -k /keys/private.pem -a encrypted-script

⁠Upload Scripts

bash

⁠Upload from file

docker run -it --rm
-v ~/.shebangrc:/root/.shebangrc
-v $(pwd):/workspace
dingbatter/shebangcli put -n myscript -v public -f /workspace/script.sh

⁠Upload from stdin

cat script.sh | docker run -i --rm
-v ~/.shebangrc:/root/.shebangrc
dingbatter/shebangcli put -n myscript -v public -s

⁠Configuration

Config file: ~/.shebangrc

bash SHEBANG_URL="https://shebang.run⁠" SHEBANG_USERNAME="myuser" SHEBANG_CLIENT_ID="..." SHEBANG_CLIENT_SECRET="..." SHEBANG_KEY_PATH="/path/to/key.pem"

Generated automatically with shebang login or download from Account page on shebang.run.

⁠Image Details

• Base: python:3.11-alpine
• Size: 134MB
• Includes: shebangrun Python package, cryptography, pynacl
• Supports: Automatic decryption of encrypted scripts

⁠Alternative Installation

Install directly with pip (no Docker needed):

bash pip install shebangrun shebang login shebang list

⁠Links

• Platform: https://shebang.run⁠
• GitHub: https://github.com/skibare87/shebangrun⁠
• PyPI: https://pypi.org/project/shebangrun/⁠
• Full Image: docker.io/dingbatter/shebangrun (includes web UI)

⁠License

MIT License