Skip to main content

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)

Source distribution for softmax-cli 0.26.39
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)

Table of built distributions (wheels) for softmax-cli 0.26.39
File Interpreter ABI Platform Actions
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 log

Release 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 log

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

Select from 2 files

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 log

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

Release history Release notifications | RSS feed

This release

0.26.39 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page