Metadata-Version: 2.4
Name: fluxhive-cli
Version: 0.1.0
Summary: FluxHive control-plane command line client
Author: FluxHive Team
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# @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:

```bash
fluxhive
fluxhivectl
```

## npm Install

```bash
npm install -g @fluxhive/cli
```

## PyPI Install

```bash
pipx install fluxhive-cli
```

The compatibility package `fluxhivectl` also installs the same CLI:

```bash
pipx install fluxhivectl
```

Or with pip:

```bash
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:

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

On Windows PowerShell:

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

## Development Install

```bash
python -m pip install -e .
npm test
```

## Quick Start

```bash
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:

```bash
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`
