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.0.tar.gz
(12.7 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.0-py3-none-any.whl
(12.1 kB
view details)
File details
Details for the file parad-1.0.0.tar.gz.
File metadata
- Download URL: parad-1.0.0.tar.gz
- Upload date:
- Size: 12.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f6aa8ab8ad46cc759412fc8d87639761a54fbb26353f00c9cbed64cdbcc8308c
|
|
| MD5 |
e5aee0ba52fc5635f002bf1e53504ac7
|
|
| BLAKE2b-256 |
42a953147f5700280e1b2f2ae006ac0d447b1d85d8a0542e27c74fa53db64c1c
|
File details
Details for the file parad-1.0.0-py3-none-any.whl.
File metadata
- Download URL: parad-1.0.0-py3-none-any.whl
- Upload date:
- Size: 12.1 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 |
f70b6d66d9689e6d9fd83de22a75f7f8718af609bcd95aee4ba450c56d3c9b76
|
|
| MD5 |
2725abf5d4b38228a67b2f12420cfdf5
|
|
| BLAKE2b-256 |
f55d24a579c9b01a8d2438118503042c41db9bd3adba6eb56108ec3549151334
|
