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-2.0.0.tar.gz
(12.6 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-2.0.0-py3-none-any.whl
(12.3 kB
view details)
File details
Details for the file nexinal-2.0.0.tar.gz.
File metadata
- Download URL: nexinal-2.0.0.tar.gz
- Upload date:
- Size: 12.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb29ef576dfd51a2660161891e8973d02b4d31db567dd5b4c72541d28ab14b30
|
|
| MD5 |
e6265f7c43a5a3c4abd08cb440132166
|
|
| BLAKE2b-256 |
634a92d2923c8334f0497a158d9d5933610497bea3a149ca529fcaefab0332f0
|
File details
Details for the file nexinal-2.0.0-py3-none-any.whl.
File metadata
- Download URL: nexinal-2.0.0-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 |
626909321cbfefe5832733800c087ed555094713ed177a3c2fd29b1ea3908b20
|
|
| MD5 |
e5dbf93dedd00df3d24b746030d98642
|
|
| BLAKE2b-256 |
fbe413609c2284199a63f5a83a983cd01923862f809ed32710faed0a88e8bac0
|