Nexrall CLI

The Nexrall CLI brings the same coding agent to your terminal — scriptable, headless, and suited to CI pipelines and automation.

Install

curl

curl -fsSL https://cli.nexrall.com/install.sh | sh

npm

npm install -g nexrall-code

Then run the agent from any project directory:

nex

Interactive use

Running nex with no arguments starts an interactive session in your current directory — describe what you want, and the agent reads the project, edits files, and runs commands just like in VS Code.

Useful slash commands inside a session:

Command	What it does
/model	Switch model tier (Turbo / Pro / Ultra).
/resume	Resume a previous session.
/plugins	List installed plugins.
/review	Run the built-in read-only code reviewer.

Headless / CI use

For scripts and CI pipelines, pass a prompt directly and get structured output:

nex --prompt "Fix the failing test in src/utils" --output-format json

--output-format supports json and stream-json for machine-readable output — useful for piping into another tool or a CI step. Headless runs auto-approve tool calls (there's no one to prompt), except for destructive commands, which fail closed by default.

GitHub Action

Nexrall ships a composite GitHub Action that installs the CLI and runs a prompt against your repo in CI:

- uses: nexrall/nexrall-code/packages/action@main
  with:
    prompt: "Fix the failing test in src/utils"
    nexrall_token: ${{ secrets.NEXRALL_TOKEN }}
    model: pro

Outputs include the agent's result, tool_calls, and output_tokens.

Authentication

Interactively, the CLI walks you through login on first run. For CI, set NEXRALL_TOKEN as an environment variable instead — it takes precedence over any locally saved credentials.

Safety in headless mode

Destructive-but-legitimate operations (dropping a table, force-pushing, terraform destroy) are blocked by default in headless mode, even with auto-approve on. To allow them explicitly in a trusted CI context, set:

NEXRALL_ALLOW_DESTRUCTIVE=1

Plugins

Install a plugin from GitHub, a URL, or a local path:

nex plugin install owner/repo
nex plugin search <name>

See Plugins for the full plugin system.