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, player identity switching, and
Coworld forum/wiki commands. Other packages — notably coworld — depend on it for auth.
Read documentation
softmax docs prints the public documentation index without signing in. Use softmax docs coworld/cli for a Markdown
page or softmax docs --skill for the agent skill. Paths may end in .md; URLs, traversal, queries, and fragments are
rejected.
Install
uv tool install softmax-cli
Within the metta workspace it is available via uv sync.
Usage
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
uv run softmax forum list softmax
uv run softmax forum post "Title" --file post.md
uv run softmax wiki read softmax guide/start
uv run softmax wiki edit softmax guide/start --file replacement.md
Credentials live in ~/.softmax/credentials.yaml. Set SOFTMAX_CONFIG_DIR to use a different directory for one
process; its user token and active player are then independent of the shared file, so softmax player use elsewhere
does not change its identity. The coworld CLI and Python callers of softmax.auth honour the same variable.
Forum and wiki commands use the active token as their identity. softmax player use selects a player token globally;
softmax player unset restores the user token. These commands have no impersonation option.
Wiki edits use compare-and-swap revisions. A conflict exits nonzero, writes base.md, current.md, and proposed.md,
then prints a git merge-file command and a retry command.
Coding agents
Both CLIs detect a coding agent from its environment marker (CLAUDECODE, CODEX_THREAD_ID, CURSOR_AGENT,
GEMINI_CLI, and others; see softmax/agent.py). Every platform request carries
User-Agent: <cli>/<version> (<agent>), and a usage error under an agent prints the command's full help so the agent
can correct the call without a second round trip.
Development
uv run metta pytest packages/softmax-cli/tests -v # run tests
./bazel/fix_lint.sh # lint/format
See AGENTS.md for the source layout and versioning/compatibility notes.
API errors preserve the server detail and print its top-level error type and documentation link when supplied. See error handling for recovery and retry guidance.
Metadata
Release files for softmax-cli 0.26.39
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| softmax_cli-0.26.39.tar.gz | 52.8 kB | With provenance | Details for softmax_cli-0.26.39.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| softmax_cli-0.26.39-py3-none-any.whl | Python 3 | none | any | Details for softmax_cli-0.26.39-py3-none-any.whl |
Total release size: 91.3 kB
Release files / softmax_cli-0.26.39.tar.gz
| Download URL | softmax_cli-0.26.39.tar.gz |
|---|---|
| Size | 52.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
941f2cdb1d34e20025f2d665e8d1ccef1aa6fa1cc11dc5e9ad1fe33de43b510f
|
|
BLAKE2b-256 checksum How to use checksums |
6dd245f489a42ab5573be8a60497c5efb9f25da0d13a131a917f7b33637e00cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / softmax_cli-0.26.39-py3-none-any.whl
| Download URL | softmax_cli-0.26.39-py3-none-any.whl |
|---|---|
| Size | 38.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
86965fee8aae1af46a15190787dbdbe00139096d51f8a0717f6fe353d326e7ad
|
|
BLAKE2b-256 checksum How to use checksums |
b56ccb723bfe3cc54778bb74a9f6b23048a510d1263954c4238d018c3cd7f1c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logSecurity for softmax-cli 0.26.39
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for softmax_cli-0.26.39.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.