Metadata-Version: 2.4
Name: intflow-authctl
Version: 0.2.0
Summary: Intflow Auth operator CLI.
Author: Intflow
License: Proprietary
Requires-Python: >=3.12
Requires-Dist: httpx<1,>=0.28
Requires-Dist: keyring<26,>=25
Provides-Extra: dev
Requires-Dist: build<2,>=1.2; extra == 'dev'
Requires-Dist: hatchling<2,>=1.27; extra == 'dev'
Requires-Dist: mypy<3,>=1.13; extra == 'dev'
Requires-Dist: packaging<27,>=24; extra == 'dev'
Requires-Dist: pytest-cov<8,>=6; extra == 'dev'
Requires-Dist: pytest-timeout<3,>=2.4; extra == 'dev'
Requires-Dist: pytest<10,>=8; extra == 'dev'
Requires-Dist: ruff<1,>=0.9; extra == 'dev'
Requires-Dist: twine<7,>=6; extra == 'dev'
Description-Content-Type: text/markdown

# intflow-authctl

`intflow-authctl` is the Python operator CLI package for Intflow Auth.

## Install

```powershell
py -3.12 -m pip install --user --upgrade intflow-authctl
```

## CLI

```powershell
intflow-authctl login
intflow-authctl whoami
intflow-authctl users list
intflow-authctl clients list
intflow-authctl clients rotate-secret <oauth-client-id> --grace-seconds 0
intflow-authctl logout --revoke
```

The CLI is intended for authorized Intflow operators. It manages local operator
credentials through the supported credential backends and communicates with an
Intflow Auth deployment over the Admin API.

Failed commands return a nonzero exit code and write a bounded diagnostic to
stderr. Admin HTTP failures include only the status, a validated service error
code when present, and bounded `Retry-After` guidance. Upstream descriptions,
malformed bodies, credentials, and raw transport causes are not rendered.
Automation should parse JSON stdout only after a successful command.

## Package Scope

This distribution contains only the operator CLI, Admin API client, output and
validation logic, and credential-store adapters. It does not contain the Auth
service, database models, migrations, or service bootstrap commands.

## Requirements

- Python 3.12 or later.
- Access to an authorized Intflow Auth deployment.
