Metadata-Version: 2.4
Name: softmax-cli
Version: 0.26.14
Summary: Softmax CLI — authentication and account tools
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: <3.13,>=3.11
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.19.2
Requires-Dist: rich>=13.7.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn>=0.34.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: pyyaml>=6.0.2
Provides-Extra: cogames
Requires-Dist: cogames; extra == "cogames"

# softmax-cli

The `softmax` command-line tool: authentication and account management for Softmax / Observatory. It provides
browser-based login (with a local callback server), token storage, and account status. Other packages — notably
`coworld` — depend on it for auth. Installing with the `cogames` extra mounts the cogames CLI as a `softmax cogames`
subcommand.

## Install

```bash
uv tool install softmax-cli            # standalone
uv tool install "softmax-cli[cogames]" # with the cogames subcommand
```

Within the metta workspace it is available via `uv sync`.

## Usage

```bash
uv run softmax login           # log in via the browser
uv run softmax status          # show current auth status
uv run softmax logout
uv run softmax get-token       # print the stored token
uv run softmax set-token       # store a token manually
uv run softmax cogames ...     # only with the `cogames` extra
```

## Development

```bash
uv run metta pytest packages/softmax-cli/tests -v   # run tests
uv run metta lint --fix                              # lint/format
```

See [AGENTS.md](AGENTS.md) for the source layout and versioning/compatibility notes.
