nexinal
CLI client for the Nexuss Bash remote execution API. Run shell commands on a remote server directly from your terminal.
Installation
pip install nexinal
Or from source:
git clone https://github.com/nexuss0781/Nexuss-Bash
cd Nexuss-Bash/cli
pip install -e .
Quick Start
# Authenticate
nexinal auth YOUR_API_TOKEN
# Run commands
nexinal run "echo hello" "whoami" "ls /workspace"
# Execute a YAML file
nexinal execute runbook.yaml
# Check status
nexinal status
Commands
| Command | Description |
|---|---|
nexinal auth <token> |
Save authentication token |
nexinal run <commands...> |
Run shell commands sequentially |
nexinal execute <yaml_file> |
Execute commands from a YAML file |
nexinal status |
Show connection and token info |
nexinal history |
List past runs |
nexinal health |
Quick health check |
nexinal sessions |
List active sessions |
nexinal packages list |
List installed packages |
nexinal packages install <name> |
Install a package |
nexinal config |
Show or set API URL |
nexinal 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 ~/.nexinal/config.json.
# Set custom API URL
nexinal config set https://my-server.example.com
# Show current config
nexinal config
Environment
- Python 3.8+
- Works on Linux, macOS, Windows
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nexinal-1.0.2.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
nexinal-1.0.2-py3-none-any.whl
(12.3 kB
view details)
File details
Details for the file nexinal-1.0.2.tar.gz.
File metadata
- Download URL: nexinal-1.0.2.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 |
29259c80492b9863f68bef9b7a2e9905ac438d22cbaad5b5c05278d9cd813740
|
|
| MD5 |
a1ffb41371673a4ada3fa9173e70cf3d
|
|
| BLAKE2b-256 |
395340f9a250f2945bdfb6c7ca258133d8d1cc58837fbb4fd49848dfaae86785
|
File details
Details for the file nexinal-1.0.2-py3-none-any.whl.
File metadata
- Download URL: nexinal-1.0.2-py3-none-any.whl
- Upload date:
- Size: 12.3 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 |
25dc965ecf3b1c72ed579f95326b18d074c7ecbc1ee8c6941c46ce72608b3deb
|
|
| MD5 |
7d45a2dd69b0cf14ec321f2cacaa3019
|
|
| BLAKE2b-256 |
ebb9a4dd7a13540825c5c58159e2285463fc0f6fb1c9addace555b8bdb94a394
|