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
Metadata
Release files for nexinal 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nexinal-2.0.0.tar.gz | 12.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nexinal-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.9 kB
Release files / nexinal-2.0.0.tar.gz
| Download URL | nexinal-2.0.0.tar.gz |
|---|---|
| Size | 12.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb29ef576dfd51a2660161891e8973d02b4d31db567dd5b4c72541d28ab14b30
|
|
BLAKE2b-256 checksum How to use checksums |
634a92d2923c8334f0497a158d9d5933610497bea3a149ca529fcaefab0332f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / nexinal-2.0.0-py3-none-any.whl
| Download URL | nexinal-2.0.0-py3-none-any.whl |
|---|---|
| Size | 12.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
626909321cbfefe5832733800c087ed555094713ed177a3c2fd29b1ea3908b20
|
|
BLAKE2b-256 checksum How to use checksums |
fbe413609c2284199a63f5a83a983cd01923862f809ed32710faed0a88e8bac0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|