N-Bash — Remote Bash for NeuronDB

Interactive SNL terminal and remote bash executor for NeuronDB.

Install

npm install -g neuron-bash

Usage

nbash
# or
neuron-bash

You'll be prompted for:

• Node URL — NeuronDB server (e.g., https://api.neuron-db.com)
• Instance — NeuronDB instance (default: system)
• Username / Password — Your NeuronDB credentials
• Session name — Name for this bash session (default: hostname)

Features

Interactive SNL Terminal

Type any SNL command and it executes on the server:

nbash> GET() ON(main.users.*) GO()
nbash> SET() VALUE({"hello":"world"}) ON(main.test.key1) GO()

Remote Bash Execution

From NeuronDB Studio or another terminal, run commands on the machine where nbash is connected:

BASH("ls -la") GO(result)
BASH("echo hello", "my-laptop") GO(result)
CATALOG(Bash) GO()

Results are written to __nbash_results.{request_id} and can be retrieved with:

GET() ON(system.main.__nbash_results.{request_id}) GO(data)

Sandbox Security

All commands execute in ~/neuron-home/{instance}/ with:

• Restricted PATH
• 30s timeout
• 1MB output buffer
• Blocked dangerous commands (sudo, rm /, etc.)
• Path traversal prevention

Requirements

• Node.js >= 18.0.0
• A running NeuronDB server

License

MIT