Metadata-Version: 2.4
Name: topicflow-cli
Version: 0.1.2
Summary: TopicFlow remote CLI.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx<1.0,>=0.28
Requires-Dist: typer<1.0,>=0.12

# TopicFlow CLI

`topicflow-cli` is the standalone remote CLI for TopicFlow.

It talks to a deployed TopicFlow API over HTTP:

`topicflow -> HTTP API -> TopicFlow services`

## Install

Recommended:

```bash
pipx install topicflow-cli
```

Upgrade:

```bash
pipx upgrade topicflow-cli
```

Run without adding it to `PATH`:

```bash
pipx run topicflow-cli --help
```

## Configuration

Default API base URL:

```text
http://127.0.0.1:8000
```

Environment variables:

```bash
TOPICFLOW_CLI_API_BASE_URL=http://topicflow.example.com
TOPICFLOW_CLI_TIMEOUT_SECONDS=600
```

Or override per command:

```bash
topicflow --base-url http://topicflow.example.com system doctor
```

## Quick Start

```bash
topicflow --help
topicflow system doctor
topicflow product list
```

## Publish

Build the standalone package from the repo root:

```bash
python -m pip install build twine
python -m build apps/cli
python -m twine check apps/cli/dist/*
```

Upload to TestPyPI:

```bash
python -m twine upload --repository testpypi apps/cli/dist/*
```

Upload to PyPI:

```bash
python -m twine upload apps/cli/dist/*
```

After publishing, end users can install with:

```bash
pipx install topicflow-cli
```
