nexroo-cli 1.4.0

CLI wrapper for ai-rooms-script with Zitadel authentication

Nexroo CLI

📚 Full Documentation: https://docs.nexroo.ai

CLI wrapper for Nexroo workflow engine with authentication and package management.

Prerequisites

Python 3.11+ is required for addon packages to work. The engine itself is a standalone binary, but addons are installed to your system Python.

• Windows: Download Python
• Linux: apt install python3 or yum install python3
• macOS: brew install python3

Installation

Quick Install (Recommended)

# install CLI
pip install nexroo-cli
# use CLI to install engine
nexroo install

or

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/nexroo-ai/nexroo-cli/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/nexroo-ai/nexroo-cli/main/install.ps1 | iex

Quick Start

After installation, authenticate and run your first workflow:

(optionnal, for SaaS features like pulling/pushing workflows revisions)

# Authenticate with Nexroo
nexroo login

Run a workflow

nexroo run workflow.json

Usage

Authentication Commands

Login

nexroo login

Opens browser for Zitadel authentication.

Logout

nexroo logout

Clears saved credentials.

Status

nexroo status

Shows authentication status and token expiration.

Running Workflows

With authentication (SaaS features enabled):

nexroo run workflow.json [entrypoint]

Without authentication (local-only mode):

nexroo run workflow.json --no-auth

Additional Options

nexroo run workflow.json [entrypoint] [options]

Refer to Nexroo Documentation for all available options.

Update

pip install --upgrade nexroo-cli
nexroo update

Uninstall

# Uninstall engine, addons, and all data
nexroo uninstall

# Remove the CLI package
pip uninstall nexroo-cli

Addon Packages

Installing Addons

Addons extend the engine with additional capabilities (AI providers, databases, storage, etc.).

# Install an addon
nexroo addon install redis

# List available addons
nexroo addon list --available

# List installed addons
nexroo addon list

Troubleshooting Addon Issues

If the engine can't find an addon:

1. Verify Python 3.11+ is installed:

   python3 --version
   

2. Check addon installation:

   nexroo addon list
   python3 -m pip list | grep rooms-pkg
   

3. Reinstall addon:

   nexroo addon install <addon_name> --upgrade
   

Storage Locations

• Engine: Installed via pip to Python's site-packages (available as nexroo-engine or nexroo run)
• Addon packages: System Python's site-packages
• Encrypted tokens: ~/.nexroo/auth_token.enc
• Encryption key: ~/.nexroo/.key
• Addon metadata: ~/.nexroo/installed_packages.json
• Engine version: ~/.nexroo/.engine_version
• Download cache: ~/.nexroo/cache/

Troubleshooting

For debug use '--verbose'

Authentication fails

nexroo logout
nexroo login

Token expired

nexroo status
nexroo login   # Re-authenticate

Documentation

See Nexroo Engine Documentation to know how to use Nexroo workflow engine.

License

Nexroo Engine Free Use License v1.0 - see LICENSE file for details.

Support

• GitHub Issues: https://github.com/nexroo-ai/nexroo-cli/issues