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. Portable credentials and HTTP clients live in the bundled softmax_client modules. Coworld mounts the CLI's shared command groups.

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_client.credentials 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_client.agent). 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.

Publishing

Run metta publish softmax from a clean main checkout. The softmax-v* release publishes one softmax-cli wheel containing both softmax and softmax_client, then updates the existing public CLI mirror. The existing release-softmax.yml workflow and softmax-pypi environment remain the release authority.

See the publishing guide for previews and Coworld release order.

Development

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

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.40
File Size Uploaded Provenance Actions
softmax_cli-0.26.40.tar.gz 56.6 kB With provenance Details for softmax_cli-0.26.40.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for softmax-cli 0.26.40
File Interpreter ABI Platform Actions
softmax_cli-0.26.40-py3-none-any.whl Python 3 none any Details for softmax_cli-0.26.40-py3-none-any.whl

Total release size: 94.9 kB

Release files / softmax_cli-0.26.40.tar.gz

Download URL softmax_cli-0.26.40.tar.gz
Size 56.6 kB
Tags Source
SHA-256 checksum
How to use checksums
25470f0dae58cc591f9dfb0e14ad1d4cf998c0a6e39fec10b10bf1a507d9097f
BLAKE2b-256 checksum
How to use checksums
3c1fc65cb650f9eb9acba79a811f1ab77dc1adadb93a0a17764dc14ad771b673
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 23, 2026.

Transparency log

Release files / softmax_cli-0.26.40-py3-none-any.whl

Download URL softmax_cli-0.26.40-py3-none-any.whl
Size 38.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6942eb7814a1a728b37cd6eb718b40ea4e56e3f0aebe2def5d34d4950f338905
BLAKE2b-256 checksum
How to use checksums
2ed1efc28a799ca72fddae176118e49bd33978779a449bf9663c3d7d2eb8f041
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 23, 2026.

Transparency log

Security for softmax-cli 0.26.40

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.40.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 23, 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.40 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