Metadata-Version: 2.4
Name: haliosai-cli
Version: 2.0.0
Summary: Halios CLI for coding-agent evaluations, guardrails, and OpenTelemetry evidence
Author-email: HaliosLabs <support@halios.ai>
License-Expression: Apache-2.0
Project-URL: Homepage, https://halios.ai
Project-URL: Documentation, https://docs.halios.ai
Project-URL: Repository, https://github.com/HaliosAI/halios
Project-URL: Changelog, https://github.com/HaliosAI/halios/releases
Keywords: ai,agents,evaluation,guardrails,opentelemetry,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx<1,>=0.27
Requires-Dist: jsonschema<5,>=4.18
Requires-Dist: PyYAML<7,>=6.0
Requires-Dist: rich<15,>=13
Requires-Dist: typer<1,>=0.12
Requires-Dist: tomli>=2.0; python_version < "3.11"
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: ruff>=0.9; extra == "dev"
Requires-Dist: twine>=6; extra == "dev"
Dynamic: license-file

# Halios CLI and Agent Skill

The `halios` command is the machine-facing client used by the Halios Agent Skill and CI. It owns
repository setup, evaluation-suite authoring, fresh scenario execution, evidence inspection, and
prompt-optimization handoffs. Applications export their runtime telemetry with stock
OpenTelemetry; the CLI is not an application tracing SDK.

```bash
uv tool install 'haliosai-cli>=2.0.0'
halios --version
```

Use `pipx install 'haliosai-cli>=2.0.0'` when `uv` is unavailable. Install the cross-harness skill
separately:

```bash
npx skills add HaliosAI/halios --skill halios
```

The stable project workflow is:

```bash
halios auth login
halios project init --agent support-assistant --command "python tests/halios_adapter.py"
halios eval review --json
halios project configure --json
halios project check --json
halios eval run -k 3 --json
```

Prompt optimization is driven by the coding agent and the normal immutable eval workflow:

```bash
halios optimize start --baseline-run <run-id> --prompt-file path/to/system-prompt.txt --json
# make one bounded prompt edit from the returned guidance, then run the unchanged suite
halios eval run -k 3 --json
halios optimize record <optimization-run-id> \
  --evaluation-run <candidate-eval-run-id> \
  --prompt-file path/to/system-prompt.txt \
  --json
```

Credentials are stored outside the repository. The repository contains only `.halios/config.toml`,
`.halios/eval.yml`, and `.halios/scenarios.yml`.

In non-interactive CI, use `HALIOS_API_KEY` for control-plane commands and the separate
agent-scoped `HALIOS_OTLP_TOKEN` for adapter trace export. Only trusted default-branch jobs should
receive `HALIOS_CI_PUBLISH_TOKEN`. The jsonl adapter is used by local/CI simulation only; deployed
staging and production applications export their own stock OpenTelemetry directly to Halios.

See the repository's
[`skills/halios`](https://github.com/HaliosAI/halios/tree/main/skills/halios) workflow for
coding-agent setup and
[`OTEL_SCHEMA.md`](https://github.com/HaliosAI/haliosai-python-sdk/blob/main/OTEL_SCHEMA.md)
for the telemetry accepted by Halios.

## Development

```bash
python -m pip install -e '.[dev]'
python -m pytest -q
```

See [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution and release process.
