treqs-cli

treqs-cli is the command-line control plane for TReqs. The current slice covers authentication, identity, project discovery, repo-local project context, training request lifecycle commands, compute target discovery, and project job inspection.

Installation

Install treqs-cli in an isolated tool environment (Python 3.10+):

uv tool install treqs-cli
# or
pipx install treqs-cli

To install it in an existing environment instead:

uv pip install treqs-cli
# or
pip install treqs-cli

Verify the console script after installation:

treqs --version
treqs --help

Development

python -m venv .venv
. .venv/bin/activate
pip install -e ".[dev]"
pytest
ruff check .
mypy src/treqs_cli

Local E2E

tests/e2e/ is a local-only harness and is intentionally ignored by git. It targets the PM2-managed local treqs-api e2e service and database.

Run it explicitly:

TREQS_CLI_E2E=1 pytest tests/e2e -q

Useful overrides:

TREQS_E2E_API_URL=http://127.0.0.1:3202
TREQS_E2E_DEV_EMAIL=jon+test1@treqs.ai
TREQS_E2E_PROJECT_PREFIX=treqs-cli-e2e

Default pytest remains fast and deterministic; local e2e tests are skipped unless TREQS_CLI_E2E=1 is set.

Commands

treqs login
treqs whoami
treqs projects list
treqs project use <owner>/<project>
treqs project status
treqs tr list
treqs tr create --title "Train MNIST" --workflow-snapshot-id <snapshot-id>
treqs tr show <request-id>
treqs tr update <request-id> --title "Train Fashion MNIST"
treqs tr update <request-id> --clear-workflow-path --clear-compute-target
treqs tr open <request-id> --workflow-path ".treqs/workflows/train.yaml" --compute-target <target>
treqs tr queue <request-id>
treqs compute targets list --owner <owner>
treqs jobs list --status QUEUED
treqs jobs show <job-id>

The CLI stores global auth state under the platform config directory, or TREQS_CONFIG_HOME when set. Repo context is written to .treqs/config.toml.