@fluxhive/cli

Node-installable launcher and Python implementation for the FluxHive control-plane CLI.

The CLI talks to Control Server HTTP APIs and does not implement scheduling or agent runtime logic locally.

The package exposes two equivalent commands:

fluxhive
fluxhivectl

npm Install

npm install -g @fluxhive/cli

PyPI Install

pipx install fluxhive-cli

The compatibility package fluxhivectl also installs the same CLI:

pipx install fluxhivectl

Or with pip:

python -m pip install fluxhive-cli

Python 3.10 or newer must be available on PATH. You can also point the launcher at a specific Python executable:

FLUXHIVE_PYTHON=/path/to/python fluxhive --version

On Windows PowerShell:

$env:FLUXHIVE_PYTHON = "C:\Python312\python.exe"
fluxhive --version

Development Install

python -m pip install -e .
npm test

Quick Start

fluxhive config base_url http://127.0.0.1:8001
fluxhive auth login --username <username>

fluxhive jobs list
fluxhive agents list
fluxhive runs list --limit 20

You can also use environment variables:

FLUXHIVE_CONTROL_URL=http://127.0.0.1:8001
FLUXHIVE_ACCESS_TOKEN=<access-token>
FLUXHIVE_REFRESH_TOKEN=<refresh-token>

Command Groups

• auth: login, refresh tokens, inspect current user, clear local tokens
• config: read and write local CLI configuration
• jobs: create, list, inspect, publish, run, cancel, clone, and delete jobs
• runs: list run attempts, inspect run attempts, print stored run logs
• agents: list agents, inspect GPUs, inspect queues, rename agents
• nodes: alias for agents