Metadata-Version: 2.4
Name: softmax-cli
Version: 0.26.20
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: fastapi>=0.115.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.19.2
Requires-Dist: uvicorn>=0.34.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-httpserver; extra == "test"

# 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, account status, and player identity switching.
Other packages — notably `coworld` — depend on it for auth.

## Install

```bash
uv tool install softmax-cli
```

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 player list     # list your players (active one highlighted)
uv run softmax player use ply_...  # act as a player in all auth-backed commands
uv run softmax player unset    # revert to your main user credential
```

## 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.
