Skip to main content

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)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nexinal-1.0.2-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

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

Hashes for nexinal-1.0.2.tar.gz
Algorithm Hash digest
SHA256 29259c80492b9863f68bef9b7a2e9905ac438d22cbaad5b5c05278d9cd813740
MD5 a1ffb41371673a4ada3fa9173e70cf3d
BLAKE2b-256 395340f9a250f2945bdfb6c7ca258133d8d1cc58837fbb4fd49848dfaae86785

See more details on using hashes here.

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

Hashes for nexinal-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 25dc965ecf3b1c72ed579f95326b18d074c7ecbc1ee8c6941c46ce72608b3deb
MD5 7d45a2dd69b0cf14ec321f2cacaa3019
BLAKE2b-256 ebb9a4dd7a13540825c5c58159e2285463fc0f6fb1c9addace555b8bdb94a394

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page