parad
CLI client for the Nexuss Bash remote execution API. Run shell commands on a remote server directly from your terminal.
Installation
pip install parad
Or from source:
git clone https://github.com/nexuss0781/Nexuss-Bash
cd Nexuss-Bash/cli
pip install -e .
Quick Start
# Authenticate
parad auth YOUR_API_TOKEN
# Run commands
parad run "echo hello" "whoami" "ls /workspace"
# Execute a YAML file
parad execute runbook.yaml
# Check status
parad status
Commands
| Command | Description |
|---|---|
parad auth <token> |
Save authentication token |
parad run <commands...> |
Run shell commands sequentially |
parad execute <yaml_file> |
Execute commands from a YAML file |
parad status |
Show connection and token info |
parad history |
List past runs |
parad health |
Quick health check |
parad sessions |
List active sessions |
parad packages list |
List installed packages |
parad packages install <name> |
Install a package |
parad config |
Show or set API URL |
parad logout |
Remove saved token |
YAML File Format
Simple format
commands:
- "echo hello"
- "whoami"
- "ls -la /workspace"
Detailed format
commands:
- name: "Print hello"
command: "echo hello"
timeout: 30
stop_on_fail: true
- name: "List files"
command: "ls -la"
timeout: 15
Configuration
Config is stored at ~/.parad/config.json.
# Set custom API URL
parad config set https://my-server.example.com
# Show current config
parad config
Environment
- Python 3.8+
- Works on Linux, macOS, Windows
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
parad-1.0.1.tar.gz
(12.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
parad-1.0.1-py3-none-any.whl
(12.2 kB
view details)
File details
Details for the file parad-1.0.1.tar.gz.
File metadata
- Download URL: parad-1.0.1.tar.gz
- Upload date:
- Size: 12.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d25f4785fd890bd9db7daa4a31166ce5eefccd8c72110845131eefdec08777ec
|
|
| MD5 |
6cb80ef8b54b357d4842dfad48b2c0c5
|
|
| BLAKE2b-256 |
c1ab075540c8a4e060631c61bdcc2809dd8c2f1c7531e272b9546608f37d53dc
|
File details
Details for the file parad-1.0.1-py3-none-any.whl.
File metadata
- Download URL: parad-1.0.1-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bcd80e3e63a56e96122cb284b3ab0f51dd6afb0f86ed3dc8bf69842a1da29627
|
|
| MD5 |
47c6344db53b84cc61ccb36e6151d49a
|
|
| BLAKE2b-256 |
910527f977c3879c8818d4efab083b19610e28d3d10f057ea5523acd6bdc97ab
|
